com.amazonaws.services.glacier.model

## クラス InitiateJobRequest

- java.lang.Object
- - com.amazonaws.AmazonWebServiceRequest
  - - com.amazonaws.services.glacier.model.InitiateJobRequest

- すべての実装されたインタフェース:
    java.io.Serializable

      public class InitiateJobRequest
      extends AmazonWebServiceRequest
      implements java.io.Serializable

  Container for the parameters to the `InitiateJob operation`.

  This operation initiates a job of the specified type. In this release, you can initiate a job to retrieve either an archive or a vault inventory (a list of archives in a vault).

  Retrieving data from Amazon Glacier is a two-step process:

  1. Initiate a retrieval job.

  2. After the job completes, download the bytes.

  The retrieval request is executed asynchronously. When you initiate a retrieval job, Amazon Glacier creates a job and returns a job ID in the response. When Amazon Glacier completes the job, you can get the job output (archive or inventory data). For information about getting job output, see GetJobOutput operation.

  The job must complete before you can get its output. To determine when a job is complete, you have the following options:

  - Use Amazon SNS Notification You can specify an Amazon Simple Notification Service (Amazon SNS) topic to which Amazon Glacier can post a notification after the job is completed. You can specify an SNS topic per job request. The notification is sent only after Amazon Glacier completes the job. In addition to specifying an SNS topic per job request, you can configure vault notifications for a vault so that job notifications are always sent. For more information, see SetVaultNotificationConfiguration.

  - Get job details You can make a DescribeJob request to obtain job status information while a job is in progress. However, it is more efficient to use an Amazon SNS notification to determine when a job is complete.

  NOTE: The information you get via notification is same that you get by calling DescribeJob.

  If for a specific event, you add both the notification configuration on the vault and also specify an SNS topic in your initiate job request, Amazon Glacier sends both notifications. For more information, see SetVaultNotificationConfiguration.

  An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM) .

  About the Vault Inventory

  Amazon Glacier prepares an inventory for each vault periodically, every 24 hours. When you initiate a job for a vault inventory, Amazon Glacier returns the last inventory for the vault. The inventory data you get might be up to a day or two days old. Also, the initiate inventory job might take some time to complete before you can download the vault inventory. So you do not want to retrieve a vault inventory for each vault operation. However, in some scenarios, you might find the vault inventory useful. For example, when you upload an archive, you can provide an archive description but not an archive name. Amazon Glacier provides you a unique archive ID, an opaque string of characters. So, you might maintain your own database that maps archive names to their corresponding Amazon Glacier assigned archive IDs. You might find the vault inventory useful in the event you need to reconcile information in your database with the actual vault inventory.

  An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM) .

  For conceptual information and the underlying REST API, go to Initiate a Job and Downloading a Vault Inventory

  関連項目:
    `AmazonGlacier.initiateJob(InitiateJobRequest)`, 直列化された形式

- - ### コンストラクタの概要

    コンストラクタ
    コンストラクタと説明
    `InitiateJobRequest()` Default constructor for a new InitiateJobRequest object.
    `InitiateJobRequest(java.lang.String vaultName, JobParameters jobParameters)` Constructs a new InitiateJobRequest object.
    `InitiateJobRequest(java.lang.String accountId, java.lang.String vaultName, JobParameters jobParameters)` Constructs a new InitiateJobRequest object.

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `boolean` | `equals(java.lang.Object obj)`
    `java.lang.String` | `getAccountId()` The `AccountId` is the AWS Account ID.
    `JobParameters` | `getJobParameters()` Provides options for specifying job information.
    `java.lang.String` | `getVaultName()` The name of the vault.
    `int` | `hashCode()`
    `void` | `setAccountId(java.lang.String accountId)` The `AccountId` is the AWS Account ID.
    `void` | `setJobParameters(JobParameters jobParameters)` Provides options for specifying job information.
    `void` | `setVaultName(java.lang.String vaultName)` The name of the vault.
    `java.lang.String` | `toString()` Returns a string representation of this object; useful for testing and debugging.
    `InitiateJobRequest` | `withAccountId(java.lang.String accountId)` The `AccountId` is the AWS Account ID.
    `InitiateJobRequest` | `withJobParameters(JobParameters jobParameters)` Provides options for specifying job information.
    `InitiateJobRequest` | `withVaultName(java.lang.String vaultName)` The name of the vault.

    - ### クラスから継承されたメソッド com.amazonaws.AmazonWebServiceRequest

      `copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentials`

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

- - ### コンストラクタの詳細

    - #### InitiateJobRequest

          public InitiateJobRequest()

      Default constructor for a new InitiateJobRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

    - #### InitiateJobRequest

          public InitiateJobRequest(java.lang.String vaultName,
                            JobParameters jobParameters)

      Constructs a new InitiateJobRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.
      パラメータ:
        `vaultName` - The name of the vault.
        `jobParameters` - Provides options for specifying job information.

    - #### InitiateJobRequest

          public InitiateJobRequest(java.lang.String accountId,
                            java.lang.String vaultName,
                            JobParameters jobParameters)

      Constructs a new InitiateJobRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.
      パラメータ:
        `accountId` - The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.
        `vaultName` - The name of the vault.
        `jobParameters` - Provides options for specifying job information.

  - ### メソッドの詳細

    - #### getAccountId

          public java.lang.String getAccountId()

      The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.
      戻り値:
        The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.

    - #### setAccountId

          public void setAccountId(java.lang.String accountId)

      The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.
      パラメータ:
        `accountId` - The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.

    - #### withAccountId

          public InitiateJobRequest withAccountId(java.lang.String accountId)

      The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.

      Returns a reference to this object so that method calls can be chained together.

      パラメータ:
        `accountId` - The `AccountId` is the AWS Account ID. You can specify either the AWS Account ID or optionally a '-', in which case Amazon Glacier uses the AWS Account ID associated with the credentials used to sign the request. If you specify your Account ID, do not include hyphens in it.

    - #### getVaultName

          public java.lang.String getVaultName()

      The name of the vault.
      戻り値:
        The name of the vault.

    - #### setVaultName

          public void setVaultName(java.lang.String vaultName)

      The name of the vault.
      パラメータ:
        `vaultName` - The name of the vault.

    - #### withVaultName

          public InitiateJobRequest withVaultName(java.lang.String vaultName)

      The name of the vault.

      Returns a reference to this object so that method calls can be chained together.

      パラメータ:
        `vaultName` - The name of the vault.

    - #### getJobParameters

          public JobParameters getJobParameters()

      Provides options for specifying job information.
      戻り値:
        Provides options for specifying job information.

    - #### setJobParameters

          public void setJobParameters(JobParameters jobParameters)

      Provides options for specifying job information.
      パラメータ:
        `jobParameters` - Provides options for specifying job information.

    - #### withJobParameters

          public InitiateJobRequest withJobParameters(JobParameters jobParameters)

      Provides options for specifying job information.

      Returns a reference to this object so that method calls can be chained together.

      パラメータ:
        `jobParameters` - Provides options for specifying job information.

    - #### toString

          public java.lang.String toString()

      Returns a string representation of this object; useful for testing and debugging.
      オーバーライド:
        `toString` クラス内 `java.lang.Object`
      戻り値:
        A string representation of this object.
      関連項目:
        `Object.toString()`

    - #### hashCode

          public int hashCode()

      オーバーライド:
        `hashCode` クラス内 `java.lang.Object`

    - #### equals

          public boolean equals(java.lang.Object obj)

      オーバーライド:
        `equals` クラス内 `java.lang.Object`