Zuweisen der Auftragspriorität

Sie können jedem Auftrag eine numerische Priorität zuweisen, bei der es sich um eine beliebige positive Ganzzahl handeln kann. S3-Batch-Vorgänge priorisiert Aufträge entsprechend der zugewiesenen Priorität. Aufträge mit höherer Priorität (oder einem höheren Wert für den Prioritätsparameter) werden zuerst bewertet. Die Priorität wird in absteigender Reihenfolge ermittelt. So erhält beispielsweise eine Auftragswarteschlange mit einem Prioritätswert von 10 Vorrang vor einer Auftragswarteschlange mit dem Wert 1.

Sie können die Priorität eines Auftrags auch während seiner Ausführung ändern. Wenn Sie einen neuen Auftrag übermitteln, während ein Auftrag ausgeführt wird, kann der Auftrag mit niedrigerer Priorität pausieren und der Auftrag mit höherer Priorität ausgeführt werden.

Das Ändern der Auftragspriorität hat keinen Einfluss auf die Geschwindigkeit der Auftragsverarbeitung.

Anmerkung

S3-Batch-Vorgänge berücksichtigt Auftragsprioritäten auf Best Effort-Basis. Zwar werden Aufträge mit höheren Prioritäten im Allgemeinen vor Aufträgen mit niedrigeren Prioritäten ausgeführt, Amazon S3 garantiert jedoch keine strikte Reihenfolge der Aufträge.

Verwenden der S3-Konsole

So aktualisieren Sie die Auftrags-Priorität in der AWS Management Console

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Klicken Sie im linken Navigationsbereich auf Batchvorgänge.

3. Wählen Sie den spezifischen Auftrag aus, den Sie verwalten möchten.

4. Wählen Sie Action (Aktion). Wählen Sie in der Dropdown-Liste Update priority (Priorität aktualisieren).

Verwendung der AWS CLI

Im folgenden Beispiel wird die Auftragspriorität mithilfe der aktualisier AWS CLI. Eine höhere Zahl weist auf eine höhere Ausführungspriorität hin.

aws s3control update-job-priority \
    --region us-west-2 \
    --account-id acct-id \
    --priority 98 \
    --job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c

Verwendung der AWS SDK for Java

Im folgenden Beispiel wird die Priorität eines S3-Batch-Vorgangsauftrags unter Verwendung des AWS SDK for Java aktualisiert.

Weitere Informationen zur Auftragspriorität finden Sie unter Zuweisen der Auftragspriorität.

package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.UpdateJobPriorityRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateJobPriority {
    public static void main(String[] args) {
        String accountId = "Account ID";
        String jobId = "00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.updateJobPriority(new UpdateJobPriorityRequest()
                    .withAccountId(accountId)
                    .withJobId(jobId)
                    .withPriority(98));

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}