Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwendung `DescribeJob` mit einem AWS SDK oder CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeJob` verwendet wird.
Beispiele für Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Im folgenden Codebeispiel können Sie diese Aktion im Kontext sehen:
+ [Kennenlernen der Grundlagen](s3-control_example_s3-control_Basics_section.md)
------
#### [ CLI ]
**AWS CLI**
**So beschreiben Sie einen Auftrag von Amazon S3 Batch Operations**
Im folgenden `describe-job` werden die Konfigurationsparameter und der Status für den angegebenen Batchoperationsauftrag bereitgestellt.
```
aws s3control describe-job \
--account-id 123456789012 \
--job-id 93735294-df46-44d5-8638-6356f335324e
```
Ausgabe:
```
{
"Job": {
"TerminationDate": "2019-10-03T21:49:53.944Z",
"JobId": "93735294-df46-44d5-8638-6356f335324e",
"FailureReasons": [],
"Manifest": {
"Spec": {
"Fields": [
"Bucket",
"Key"
],
"Format": "S3BatchOperations_CSV_20180820"
},
"Location": {
"ETag": "69f52a4e9f797e987155d9c8f5880897",
"ObjectArn": "arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv"
}
},
"Operation": {
"S3PutObjectTagging": {
"TagSet": [
{
"Value": "true",
"Key": "confidential"
}
]
}
},
"RoleArn": "arn:aws:iam::123456789012:role/S3BatchJobRole",
"ProgressSummary": {
"TotalNumberOfTasks": 8,
"NumberOfTasksFailed": 0,
"NumberOfTasksSucceeded": 8
},
"Priority": 42,
"Report": {
"ReportScope": "AllTasks",
"Format": "Report_CSV_20180820",
"Enabled": true,
"Prefix": "batch-op-create-job",
"Bucket": "arn:aws:s3:::employee-records-logs"
},
"JobArn": "arn:aws:s3:us-west-2:123456789012:job/93735294-df46-44d5-8638-6356f335324e",
"CreationTime": "2019-10-03T21:48:48.048Z",
"Status": "Complete"
}
}
```
+ Einzelheiten zur API finden Sie [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/s3/src/main/java/com/example/s3/batch#code-examples) einrichten und ausführen.
```
/**
* Asynchronously describes the specified job.
*
* @param jobId the ID of the job to describe
* @param accountId the ID of the AWS account associated with the job
* @return a {@link CompletableFuture} that completes when the job description is available
* @throws RuntimeException if an error occurs while describing the job
*/
public CompletableFuture describeJobAsync(String jobId, String accountId) {
DescribeJobRequest jobRequest = DescribeJobRequest.builder()
.jobId(jobId)
.accountId(accountId)
.build();
return getAsyncClient().describeJob(jobRequest)
.thenAccept(response -> {
System.out.println("Job ID: " + response.job().jobId());
System.out.println("Description: " + response.job().description());
System.out.println("Status: " + response.job().statusAsString());
System.out.println("Role ARN: " + response.job().roleArn());
System.out.println("Priority: " + response.job().priority());
System.out.println("Progress Summary: " + response.job().progressSummary());
// Print out details about the job manifest.
JobManifest manifest = response.job().manifest();
System.out.println("Manifest Location: " + manifest.location().objectArn());
System.out.println("Manifest ETag: " + manifest.location().eTag());
// Print out details about the job operation.
JobOperation operation = response.job().operation();
if (operation.s3PutObjectTagging() != null) {
System.out.println("Operation: S3 Put Object Tagging");
System.out.println("Tag Set: " + operation.s3PutObjectTagging().tagSet());
}
// Print out details about the job report.
JobReport report = response.job().report();
System.out.println("Report Bucket: " + report.bucket());
System.out.println("Report Prefix: " + report.prefix());
System.out.println("Report Format: " + report.format());
System.out.println("Report Enabled: " + report.enabled());
System.out.println("Report Scope: " + report.reportScopeAsString());
})
.exceptionally(ex -> {
System.err.println("Failed to describe job: " + ex.getMessage());
throw new RuntimeException(ex);
});
}
```
+ Einzelheiten zur API finden Sie [DescribeJob](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3control-2018-08-20/DescribeJob)in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/s3/scenarios/batch#code-examples) einrichten und ausführen.
```
def describe_job_details(self, job_id: str, account_id: str) -> None:
"""
Describe detailed information about a batch job.
Args:
job_id (str): ID of the batch job
account_id (str): AWS account ID
"""
try:
response = self.s3control_client.describe_job(
AccountId=account_id,
JobId=job_id
)
job = response['Job']
print(f"Job ID: {job['JobId']}")
print(f"Description: {job.get('Description', 'N/A')}")
print(f"Status: {job['Status']}")
print(f"Role ARN: {job['RoleArn']}")
print(f"Priority: {job['Priority']}")
if 'ProgressSummary' in job:
progress = job['ProgressSummary']
print(f"Progress Summary: Total={progress.get('TotalNumberOfTasks', 0)}, "
f"Succeeded={progress.get('NumberOfTasksSucceeded', 0)}, "
f"Failed={progress.get('NumberOfTasksFailed', 0)}")
except ClientError as e:
print(f"Error describing job: {e}")
raise
```
+ Einzelheiten zur API finden Sie [DescribeJob](https://docs.aws.amazon.com/goto/boto3/s3control-2018-08-20/DescribeJob)in *AWS SDK for Python (Boto3) API* Reference.
------