D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exemples de signataires utilisant AWS CLI
<a name="cli_2_signer_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with Signer.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `cancel-signing-profile`
<a name="signer_CancelSigningProfile_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`cancel-signing-profile`.

**AWS CLI**  
**Pour supprimer un profil de signature**  
L'`cancel-signing-profile`exemple suivant supprime un profil de signature existant de AWS Signer.  

```
aws signer cancel-signing-profile \
    --profile-name MyProfile1
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [CancelSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/cancel-signing-profile.html)à la section *Référence des AWS CLI commandes*. 

### `describe-signing-job`
<a name="signer_DescribeSigningJob_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-signing-job`.

**AWS CLI**  
**Pour afficher les détails d’une tâche de signature**  
L’exemple `describe-signing-job` suivant affiche les détails de la tâche de signature spécifiée.  

```
aws signer describe-signing-job \
    --job-id 2065c468-73e2-4385-a6c9-0123456789abc
```
Sortie :  

```
{
    "status": "Succeeded",
    "completedAt": 1568412037,
    "platformId": "AmazonFreeRTOS-Default",
    "signingMaterial": {
        "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
    },
    "statusReason": "Signing Succeeded",
    "jobId": "2065c468-73e2-4385-a6c9-0123456789abc",
    "source": {
        "s3": {
            "version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
            "bucketName": "signer-source",
            "key": "MyCode.rb"
        }
    },
    "profileName": "MyProfile2",
    "signedObject": {
        "s3": {
            "bucketName": "signer-destination",
            "key": "signed-2065c468-73e2-4385-a6c9-0123456789abc"
        }
    },
    "requestedBy": "arn:aws:iam::123456789012:user/maria",
    "createdAt": 1568412036
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/describe-signing-job.html)à la section *Référence des AWS CLI commandes*. 

### `get-signing-platform`
<a name="signer_GetSigningPlatform_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-signing-platform`.

**AWS CLI**  
**Pour afficher les détails d’une plateforme de signature**  
L’exemple `get-signing-platform` suivant affiche les détails de la plateforme de signature spécifiée.  

```
aws signer get-signing-platform \
    --platform-id AmazonFreeRTOS-TI-CC3220SF
```
Sortie :  

```
{
    "category": "AWS",
    "displayName": "Amazon FreeRTOS SHA1-RSA CC3220SF-Format",
    "target": "SHA1-RSA-TISHA1",
    "platformId": "AmazonFreeRTOS-TI-CC3220SF",
    "signingConfiguration": {
        "encryptionAlgorithmOptions": {
            "defaultValue": "RSA",
            "allowedValues": [
                "RSA"
            ]
        },
        "hashAlgorithmOptions": {
            "defaultValue": "SHA1",
            "allowedValues": [
                "SHA1"
            ]
        }
    },
    "maxSizeInMB": 16,
    "partner": "AmazonFreeRTOS",
    "signingImageFormat": {
        "defaultFormat": "JSONEmbedded",
        "supportedFormats": [
            "JSONEmbedded"
        ]
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetSigningPlatform](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-platform.html)à la section *Référence des AWS CLI commandes*. 

### `get-signing-profile`
<a name="signer_GetSigningProfile_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-signing-profile`.

**AWS CLI**  
**Pour afficher les détails d’un profil de signature**  
L’exemple `get-signing-profile` suivant affiche les détails du profil de signature spécifié.  

```
aws signer get-signing-profile \
    --profile-name MyProfile3
```
Sortie :  

```
{
    "platformId": "AmazonFreeRTOS-TI-CC3220SF",
    "profileName": "MyProfile3",
    "status": "Active",
    "signingMaterial": {
        "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-profile.html)à la section *Référence des AWS CLI commandes*. 

### `list-signing-jobs`
<a name="signer_ListSigningJobs_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-signing-jobs`.

**AWS CLI**  
**Pour répertorier toutes les tâches de signature**  
L’exemple `list-signing-jobs` suivant affiche les détails de toutes les tâches de signature du compte.  

```
aws signer list-signing-jobs
```
Dans cet exemple, deux tâches sont renvoyées, l’une qui a abouti et l’autre qui a échoué.  

```
{
    "jobs": [
        {
            "status": "Succeeded",
            "signingMaterial": {
                "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
            },
            "jobId": "2065c468-73e2-4385-a6c9-0123456789abc",
            "source": {
                "s3": {
                    "version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
                    "bucketName": "signer-source",
                    "key": "MyCode.rb"
                }
            },
            "signedObject": {
                "s3": {
                    "bucketName": "signer-destination",
                    "key": "signed-2065c468-73e2-4385-a6c9-0123456789abc"
                }
            },
            "createdAt": 1568412036
        },
        {
            "status": "Failed",
            "source": {
                "s3": {
                    "version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
                    "bucketName": "signer-source",
                    "key": "MyOtherCode.rb"
                }
            },
            "signingMaterial": {
                "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
            },
            "createdAt": 1568402690,
            "jobId": "74d9825e-22fc-4a0d-b962-0123456789abc"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListSigningJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-jobs.html)à la section *Référence des AWS CLI commandes*. 

### `list-signing-platforms`
<a name="signer_ListSigningPlatforms_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-signing-platforms`.

**AWS CLI**  
**Pour répertorier toutes les plateformes de signature**  
L’exemple `list-signing-platforms` suivant affiche les détails de toutes les plateformes de signature disponibles.  

```
aws signer list-signing-platforms
```
Sortie :  

```
{
    "platforms": [
        {
            "category": "AWS",
            "displayName": "AWS IoT Device Management SHA256-ECDSA ",
            "target": "SHA256-ECDSA",
            "platformId": "AWSIoTDeviceManagement-SHA256-ECDSA",
            "signingConfiguration": {
                "encryptionAlgorithmOptions": {
                    "defaultValue": "ECDSA",
                    "allowedValues": [
                        "ECDSA"
                    ]
                },
                "hashAlgorithmOptions": {
                    "defaultValue": "SHA256",
                    "allowedValues": [
                        "SHA256"
                    ]
                }
            },
            "maxSizeInMB": 2048,
            "partner": "AWSIoTDeviceManagement",
            "signingImageFormat": {
                "defaultFormat": "JSONDetached",
                "supportedFormats": [
                    "JSONDetached"
                ]
            }
        },
        {
            "category": "AWS",
            "displayName": "Amazon FreeRTOS SHA1-RSA CC3220SF-Format",
            "target": "SHA1-RSA-TISHA1",
            "platformId": "AmazonFreeRTOS-TI-CC3220SF",
            "signingConfiguration": {
                "encryptionAlgorithmOptions": {
                    "defaultValue": "RSA",
                    "allowedValues": [
                        "RSA"
                    ]
                },
                "hashAlgorithmOptions": {
                    "defaultValue": "SHA1",
                    "allowedValues": [
                        "SHA1"
                    ]
                }
            },
            "maxSizeInMB": 16,
            "partner": "AmazonFreeRTOS",
            "signingImageFormat": {
                "defaultFormat": "JSONEmbedded",
                "supportedFormats": [
                    "JSONEmbedded"
                ]
            }
        },
        {
            "category": "AWS",
            "displayName": "Amazon FreeRTOS SHA256-ECDSA",
            "target": "SHA256-ECDSA",
            "platformId": "AmazonFreeRTOS-Default",
            "signingConfiguration": {
                "encryptionAlgorithmOptions": {
                    "defaultValue": "ECDSA",
                    "allowedValues": [
                        "ECDSA"
                    ]
                },
                "hashAlgorithmOptions": {
                    "defaultValue": "SHA256",
                    "allowedValues": [
                        "SHA256"
                    ]
                }
            },
            "maxSizeInMB": 16,
            "partner": "AmazonFreeRTOS",
            "signingImageFormat": {
                "defaultFormat": "JSONEmbedded",
                "supportedFormats": [
                    "JSONEmbedded"
                ]
            }
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListSigningPlatforms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-platforms.html)à la section *Référence des AWS CLI commandes*. 

### `list-signing-profiles`
<a name="signer_ListSigningProfiles_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-signing-profiles`.

**AWS CLI**  
**Pour répertorier tous les profils de signature**  
L’exemple `list-signing-profiles` suivant affiche les détails de tous les profils de signature du compte.  

```
aws signer list-signing-profiles
```
Sortie :  

```
{
    "profiles": [
        {
            "platformId": "AmazonFreeRTOS-TI-CC3220SF",
            "profileName": "MyProfile4",
            "status": "Active",
            "signingMaterial": {
                "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
            }
        },
        {
            "platformId": "AWSIoTDeviceManagement-SHA256-ECDSA",
            "profileName": "MyProfile5",
            "status": "Active",
            "signingMaterial": {
                "certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
            }
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListSigningProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-profiles.html)à la section *Référence des AWS CLI commandes*. 

### `put-signing-profile`
<a name="signer_PutSigningProfile_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`put-signing-profile`.

**AWS CLI**  
**Pour créer un profil de signature**  
L’exemple `put-signing-profile` suivant crée un profil de signature à l’aide du certificat et de la plateforme spécifiés.  

```
aws signer put-signing-profile \
    --profile-name MyProfile6 \
    --signing-material certificateArn=arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc \
    --platform AmazonFreeRTOS-TI-CC3220SF
```
Sortie :  

```
{
    "arn": "arn:aws:signer:us-west-2:123456789012:/signing-profiles/MyProfile6"
}
```
+  Pour plus de détails sur l'API, reportez-vous [PutSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/put-signing-profile.html)à la section *Référence des AWS CLI commandes*. 

### `start-signing-job`
<a name="signer_StartSigningJob_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`start-signing-job`.

**AWS CLI**  
**Pour lancer une tâche de signature**  
L’exemple `start-signing-job` suivant lance une tâche de signature sur le code trouvé dans la source spécifiée. Il utilise le profil spécifié pour effectuer la signature et place le code signé dans la destination spécifiée.  

```
aws signer start-signing-job \
    --source 's3={bucketName=signer-source,key=MyCode.rb,version=PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4}' \
    --destination 's3={bucketName=signer-destination,prefix=signed-}' \
    --profile-name MyProfile7
```
La sortie est l’ID de la tâche de signature.  

```
{
    "jobId": "2065c468-73e2-4385-a6c9-0123456789abc"
}
```
+  Pour plus de détails sur l'API, reportez-vous [StartSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/start-signing-job.html)à la section *Référence des AWS CLI commandes*.