Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CodeDeploy ejemplos que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with CodeDeploy.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `add-tags-to-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-tags-to-on-premises-instances`.
**AWS CLI**
**Adición de etiquetas a instancias en las instalaciones**
En el siguiente `add-tags-to-on-premises-instances` ejemplo, se asocia AWS CodeDeploy la misma etiqueta de instancia local a dos instancias locales. No registra las instancias locales con. AWS CodeDeploy
```
aws deploy add-tags-to-on-premises-instances \
--instance-names AssetTag12010298EX AssetTag23121309EX \
--tags Key=Name,Value=CodeDeployDemo-OnPrem
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [AddTagsToOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/add-tags-to-on-premises-instances.html)la *Referencia de AWS CLI comandos*.
### `batch-get-application-revisions`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-application-revisions`.
**AWS CLI**
**Obtención de información sobre las revisiones de la aplicación**
El siguiente `batch-get-application-revisions` ejemplo recupera información sobre la revisión especificada almacenada en un GitHub repositorio.
```
aws deploy batch-get-application-revisions \
--application-name my-codedeploy-application \
--revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]"
```
Salida:
```
{
"revisions": [
{
"genericRevisionInfo": {
"description": "Application revision registered by Deployment ID: d-A1B2C3111",
"lastUsedTime": 1556912355.884,
"registerTime": 1556912355.884,
"firstUsedTime": 1556912355.884,
"deploymentGroups": []
},
"revisionLocation": {
"revisionType": "GitHub",
"gitHubLocation": {
"commitId": "fa85936EXAMPLEa31736c051f10d77297EXAMPLE",
"repository": "my-github-token/my-repository"
}
}
}
],
"applicationName": "my-codedeploy-application",
"errorMessage": ""
}
```
Para obtener más información, consulta [BatchGetApplicationRevisions](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetApplicationRevisions.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [BatchGetApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-application-revisions.html)la *Referencia de AWS CLI comandos*.
### `batch-get-applications`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-applications`.
**AWS CLI**
**Obtención de información sobre varias aplicaciones**
En el siguiente `batch-get-applications` ejemplo, se muestra información sobre varias aplicaciones asociadas a la AWS cuenta del usuario.
```
aws deploy batch-get-applications --application-names WordPress_App MyOther_App
```
Salida:
```
{
"applicationsInfo": [
{
"applicationName": "WordPress_App",
"applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE",
"createTime": 1407878168.078,
"linkedToGitHub": false
},
{
"applicationName": "MyOther_App",
"applicationId": "8ca57519-31da-42b2-9194-8bb16EXAMPLE",
"createTime": 1407453571.63,
"linkedToGitHub": false
}
]
}
```
+ Para obtener más información sobre la API, consulte [BatchGetApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-applications.html)la *Referencia de AWS CLI comandos*.
### `batch-get-deployment-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployment-groups`.
**AWS CLI**
**Obtención de información sobre uno o varios grupos de implementación**
En el siguiente `batch-get-deployment-groups` ejemplo, se recupera información sobre dos de los grupos de despliegue asociados a la CodeDeploy aplicación especificada.
```
aws deploy batch-get-deployment-groups \
--application-name my-codedeploy-application \
--deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]"
```
Salida:
```
{
"deploymentGroupsInfo": [
{
"deploymentStyle": {
"deploymentOption": "WITHOUT_TRAFFIC_CONTROL",
"deploymentType": "IN_PLACE"
},
"autoRollbackConfiguration": {
"enabled": false
},
"onPremisesTagSet": {
"onPremisesTagSetList": []
},
"serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole",
"lastAttemptedDeployment": {
"endTime": 1556912366.415,
"status": "Failed",
"createTime": 1556912355.884,
"deploymentId": "d-A1B2C3111"
},
"autoScalingGroups": [],
"deploymentGroupName": "my-deployment-group-1",
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Value": "my-EC2-instance",
"Key": "Name"
}
]
]
},
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111example",
"triggerConfigurations": [],
"applicationName": "my-codedeploy-application",
"computePlatform": "Server",
"deploymentConfigName": "CodeDeployDefault.AllAtOnce"
},
{
"deploymentStyle": {
"deploymentOption": "WITHOUT_TRAFFIC_CONTROL",
"deploymentType": "IN_PLACE"
},
"autoRollbackConfiguration": {
"enabled": false
},
"onPremisesTagSet": {
"onPremisesTagSetList": []
},
"serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole",
"autoScalingGroups": [],
"deploymentGroupName": "my-deployment-group-2",
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Value": "my-EC2-instance",
"Key": "Name"
}
]
]
},
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-22222example",
"triggerConfigurations": [],
"applicationName": "my-codedeploy-application",
"computePlatform": "Server",
"deploymentConfigName": "CodeDeployDefault.AllAtOnce"
}
],
"errorMessage": ""
}
```
Para obtener más información, consulta [BatchGetDeploymentGroups](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentGroups.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [BatchGetDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-groups.html)la *Referencia de AWS CLI comandos*.
### `batch-get-deployment-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployment-targets`.
**AWS CLI**
**Obtención de los objetivos asociados a una implementación**
En el siguiente ejemplo de `batch-get-deployment-targets`, se obtiene información sobre uno de los objetivos asociados a la implementación especificada.
```
aws deploy batch-get-deployment-targets \
--deployment-id "d-1A2B3C4D5" \
--target-ids "i-01a2b3c4d5e6f1111"
```
Salida:
```
{
"deploymentTargets": [
{
"deploymentTargetType": "InstanceTarget",
"instanceTarget": {
"lifecycleEvents": [
{
"startTime": 1556918592.162,
"lifecycleEventName": "ApplicationStop",
"status": "Succeeded",
"endTime": 1556918592.247,
"diagnostics": {
"scriptName": "",
"errorCode": "Success",
"logTail": "",
"message": "Succeeded"
}
},
{
"startTime": 1556918593.193,
"lifecycleEventName": "DownloadBundle",
"status": "Succeeded",
"endTime": 1556918593.981,
"diagnostics": {
"scriptName": "",
"errorCode": "Success",
"logTail": "",
"message": "Succeeded"
}
},
{
"startTime": 1556918594.805,
"lifecycleEventName": "BeforeInstall",
"status": "Succeeded",
"endTime": 1556918681.807,
"diagnostics": {
"scriptName": "",
"errorCode": "Success",
"logTail": "",
"message": "Succeeded"
}
}
],
"targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a2b3c4d5e6f1111",
"deploymentId": "d-1A2B3C4D5",
"lastUpdatedAt": 1556918687.504,
"targetId": "i-01a2b3c4d5e6f1111",
"status": "Succeeded"
}
}
]
}
```
Para obtener más información, consulta [BatchGetDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentTargets.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [BatchGetDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-targets.html)la *Referencia de AWS CLI comandos*.
### `batch-get-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployments`.
**AWS CLI**
**Obtención de información sobre varias implementaciones**
En el siguiente `batch-get-deployments` ejemplo, se muestra información sobre varias implementaciones asociadas a la AWS cuenta del usuario.
```
aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222
```
Salida:
```
{
"deploymentsInfo": [
{
"applicationName": "WordPress_App",
"status": "Failed",
"deploymentOverview": {
"Failed": 0,
"InProgress": 0,
"Skipped": 0,
"Succeeded": 1,
"Pending": 0
},
"deploymentConfigName": "CodeDeployDefault.OneAtATime",
"creator": "user",
"deploymentGroupName": "WordPress_DG",
"revision": {
"revisionType": "S3",
"s3Location": {
"bundleType": "zip",
"version": "uTecLusEXAMPLEFXtfUcyfV8bEXAMPLE",
"bucket": "amzn-s3-demo-bucket",
"key": "WordPressApp.zip"
}
},
"deploymentId": "d-A1B2C3111",
"createTime": 1408480721.9,
"completeTime": 1408480741.822
},
{
"applicationName": "MyOther_App",
"status": "Failed",
"deploymentOverview": {
"Failed": 1,
"InProgress": 0,
"Skipped": 0,
"Succeeded": 0,
"Pending": 0
},
"deploymentConfigName": "CodeDeployDefault.OneAtATime",
"creator": "user",
"errorInformation": {
"message": "Deployment failed: Constraint default violated: No hosts succeeded.",
"code": "HEALTH_CONSTRAINTS"
},
"deploymentGroupName": "MyOther_DG",
"revision": {
"revisionType": "S3",
"s3Location": {
"bundleType": "zip",
"eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"",
"bucket": "amzn-s3-demo-bucket",
"key": "MyOtherApp.zip"
}
},
"deploymentId": "d-A1B2C3222",
"createTime": 1409764576.589,
"completeTime": 1409764596.101
}
]
}
```
+ Para obtener más información sobre la API, consulte [BatchGetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployments.html)la *Referencia de AWS CLI comandos*.
### `batch-get-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-on-premises-instances`.
**AWS CLI**
**Obtención de información acerca de una o varias instancias en las instalaciones**
En el siguiente ejemplo de `batch-get-on-premises-instances`, se obtiene información acerca de dos instancias en las instalaciones.
```
aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX
```
Salida:
```
{
"instanceInfos": [
{
"iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX",
"tags": [
{
"Value": "CodeDeployDemo-OnPrem",
"Key": "Name"
}
],
"instanceName": "AssetTag12010298EX",
"registerTime": 1425579465.228,
"instanceArn": "arn:aws:codedeploy:us-west-2:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh"
},
{
"iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag23121309EX",
"tags": [
{
"Value": "CodeDeployDemo-OnPrem",
"Key": "Name"
}
],
"instanceName": "AssetTag23121309EX",
"registerTime": 1425595585.988,
"instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag23121309EX_PomUy64Was"
}
]
}
```
+ Para obtener más información sobre la API, consulte [BatchGetOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-on-premises-instances.html)la *Referencia de AWS CLI comandos*.
### `continue-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `continue-deployment`.
**AWS CLI**
**Inicio del enrutamiento del tráfico sin tener que esperar a que transcurra un tiempo de espera especificado**
En el siguiente ejemplo de `continue-deployment`, se comienza a enrutar el tráfico de las instancias en el entorno original que están listas para empezar a transferir el tráfico a instancias en el entorno de sustitución.
```
aws deploy continue-deployment \
--deployment-id "d-A1B2C3111" \
--deployment-wait-type "READY_WAIT"
```
Este comando no genera ninguna salida.
Para obtener más información, consulta [ContinueDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ContinueDeployment.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [ContinueDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/continue-deployment.html)la *Referencia de AWS CLI comandos*.
### `create-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-application`.
**AWS CLI**
**Para crear una aplicación**
En el siguiente `create-application` ejemplo, se crea una aplicación y se asocia a la AWS cuenta del usuario.
```
aws deploy create-application --application-name MyOther_App
```
Salida:
```
{
"applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener más información sobre la API, consulte [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-application.html)la *Referencia de AWS CLI comandos*.
### `create-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment-config`.
**AWS CLI**
**Creación de una configuración de implementación personalizada**
En el siguiente `create-deployment-config` ejemplo, se crea una configuración de despliegue personalizada y se asocia a la AWS cuenta del usuario.
```
aws deploy create-deployment-config \
--deployment-config-name ThreeQuartersHealthy \
--minimum-healthy-hosts type=FLEET_PERCENT,value=75
```
Salida:
```
{
"deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener más información sobre la API, consulte [CreateDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-config.html)la *Referencia de AWS CLI comandos*.
### `create-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment-group`.
**AWS CLI**
**Creación de un grupo de implementación**
En el siguiente `create-deployment-group` ejemplo, se crea un grupo de despliegue y se asocia a la aplicación especificada y a la AWS cuenta del usuario.
```
aws deploy create-deployment-group \
--application-name WordPress_App \
--auto-scaling-groups CodeDeployDemo-ASG \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name WordPress_DG \
--ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE \
--service-role-arn arn:aws:iam::123456789012:role/CodeDeployDemoRole
```
Salida:
```
{
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener más información sobre la API, consulte [CreateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-group.html)la *Referencia de AWS CLI comandos*.
### `create-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment`.
**AWS CLI**
**Ejemplo 1: Para crear una CodeDeploy implementación mediante la plataforma informática local EC2/**
El siguiente `create-deployment` ejemplo crea una implementación y la asocia a la cuenta del usuario. AWS
```
aws deploy create-deployment \
--application-name WordPress_App \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name WordPress_DG \
--description "My demo deployment" \
--s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip
```
Salida:
```
{
"deploymentId": "d-A1B2C3111"
}
```
**Ejemplo 2: Para crear una CodeDeploy implementación con la plataforma informática Amazon ECS**
En el siguiente ejemplo de `create-deployment`, se utilizan los dos archivos siguientes para implementar un servicio de Amazon ECS.
Contenido del archivo `create-deployment.json`:
```
{
"applicationName": "ecs-deployment",
"deploymentGroupName": "ecs-deployment-dg",
"revision": {
"revisionType": "S3",
"s3Location": {
"bucket": "ecs-deployment-bucket",
"key": "appspec.yaml",
"bundleType": "YAML"
}
}
}
```
Ese archivo, a su vez, obtiene el siguiente archivo `appspec.yaml` de un bucket de S3 denominado `ecs-deployment-bucket`.
```
version: 0.0
Resources:
- TargetService:
Type: AWS::ECS::Service
Properties:
TaskDefinition: "arn:aws:ecs:region:123456789012:task-definition/ecs-task-def:2"
LoadBalancerInfo:
ContainerName: "sample-app"
ContainerPort: 80
PlatformVersion: "LATEST"
```
Comando:
```
aws deploy create-deployment \
--cli-input-json file://create-deployment.json \
--region us-east-1
```
Salida:
```
{
"deploymentId": "d-1234ABCDE"
}
```
Para obtener más información, consulta [CreateDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment.html)la *Referencia de AWS CLI comandos*.
### `delete-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-application`.
**AWS CLI**
**Eliminación de una aplicación**
En el siguiente `delete-application` ejemplo, se elimina la aplicación especificada que está asociada a la AWS cuenta del usuario.
```
aws deploy delete-application --application-name WordPress_App
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-application.html)la *Referencia de AWS CLI comandos*.
### `delete-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-deployment-config`.
**AWS CLI**
**Eliminación de una configuración de implementación**
En el siguiente `delete-deployment-config` ejemplo, se elimina una configuración de despliegue personalizada que está asociada a la AWS cuenta del usuario.
```
aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-config.html)la *Referencia de AWS CLI comandos*.
### `delete-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-deployment-group`.
**AWS CLI**
**Eliminación de un grupo de implementación**
En el siguiente ejemplo de `delete-deployment-group`, se elimina un grupo de implementación que está asociado a la aplicación especificada.
```
aws deploy delete-deployment-group \
--application-name WordPress_App \
--deployment-group-name WordPress_DG
```
Salida:
```
{
"hooksNotCleanedUp": []
}
```
+ Para obtener más información sobre la API, consulte [DeleteDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-group.html)la *Referencia de AWS CLI comandos*.
### `delete-git-hub-account-token`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-git-hub-account-token`.
**AWS CLI**
**Para eliminar la conexión de una GitHub cuenta**
En el siguiente `delete-git-hub-account-token` ejemplo, se elimina la conexión de la cuenta especificada GitHub .
```
aws deploy delete-git-hub-account-token --token-name my-github-account
```
Salida:
```
{
"tokenName": "my-github-account"
}
```
Para obtener más información, consulta [DeleteGitHubAccountToken](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteGitHubAccountToken.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [DeleteGitHubAccountToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-git-hub-account-token.html)la *Referencia de AWS CLI comandos*.
### `deregister-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister-on-premises-instance`.
**AWS CLI**
**Anulación del registro de una instancia en las instalaciones**
En el siguiente `deregister-on-premises-instance` ejemplo, se anula el registro de una instancia local AWS CodeDeploy, pero no se elimina el usuario de IAM asociado a la instancia ni se desvincula de la instancia en las etiquetas de AWS CodeDeploy la instancia local. Tampoco desinstala el AWS CodeDeploy agente de la instancia ni elimina el archivo de configuración local de la instancia.
```
aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeregisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister-on-premises-instance.html)la *Referencia de AWS CLI comandos*.
### `deregister`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister`.
**AWS CLI**
**Anulación del registro de una instancia en las instalaciones**
En el siguiente `deregister` ejemplo, se anula el registro de una instancia local con. AWS CodeDeploy No se elimina el usuario de IAM que está asociado a la instancia. Las etiquetas locales se disocian de AWS CodeDeploy la instancia en las etiquetas locales. No desinstala el AWS CodeDeploy agente de la instancia ni elimina el archivo de configuración local de la instancia.
```
aws deploy deregister \
--instance-name AssetTag12010298EX \
--no-delete-iam-user \
--region us-west-2
```
Salida:
```
Retrieving on-premises instance information... DONE
IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX
Tags: Key=Name,Value=CodeDeployDemo-OnPrem
Removing tags from the on-premises instance... DONE
Deregistering the on-premises instance... DONE
Run the following command on the on-premises instance to uninstall the codedeploy-agent:
aws deploy uninstall
```
+ Para obtener información sobre la API, consulte [Deregister](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister.html) en la *Referencia de comandos de la AWS CLI *.
### `get-application-revision`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-application-revision`.
**AWS CLI**
**Obtención de información sobre una revisión de la aplicación**
En el siguiente ejemplo de `get-application-revision`, se muestra información sobre una revisión de la aplicación asociada a la aplicación especificada.
```
aws deploy get-application-revision \
--application-name WordPress_App \
--s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip
```
Salida:
```
{
"applicationName": "WordPress_App",
"revisionInfo": {
"description": "Application revision registered by Deployment ID: d-A1B2C3111",
"registerTime": 1411076520.009,
"deploymentGroups": "WordPress_DG",
"lastUsedTime": 1411076520.009,
"firstUsedTime": 1411076520.009
},
"revision": {
"revisionType": "S3",
"s3Location": {
"bundleType": "zip",
"eTag": "dd56cfdEXAMPLE8e768f9d77fEXAMPLE",
"bucket": "amzn-s3-demo-bucket",
"key": "WordPressApp.zip"
}
}
}
```
+ Para obtener más información sobre la API, consulte [GetApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application-revision.html)la *Referencia de AWS CLI comandos*.
### `get-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-application`.
**AWS CLI**
**Obtención de información sobre una aplicación**
En el siguiente `get-application` ejemplo, se muestra información sobre una aplicación asociada a la AWS cuenta del usuario.
```
aws deploy get-application --application-name WordPress_App
```
Salida:
```
{
"application": {
"applicationName": "WordPress_App",
"applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"createTime": 1407878168.078,
"linkedToGitHub": false
}
}
```
+ Para obtener más información sobre la API, consulte [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application.html)la *Referencia de AWS CLI comandos*.
### `get-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-config`.
**AWS CLI**
**Obtención de información acerca de una configuración de implementación**
En el siguiente `get-deployment-config` ejemplo, se muestra información sobre una configuración de despliegue asociada a la AWS cuenta del usuario.
```
aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy
```
Salida:
```
{
"deploymentConfigInfo": {
"deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"minimumHealthyHosts": {
"type": "FLEET_PERCENT",
"value": 75
},
"createTime": 1411081164.379,
"deploymentConfigName": "ThreeQuartersHealthy"
}
}
```
+ Para obtener más información sobre la API, consulte [GetDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-config.html)la *Referencia de AWS CLI comandos*.
### `get-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-group`.
**AWS CLI**
**Visualización de información acerca de un grupo de implementación**
En el siguiente ejemplo de `get-deployment-group`, se muestra información sobre un grupo de implementación que está asociado a la aplicación especificada.
```
aws deploy get-deployment-group \
--application-name WordPress_App \
--deployment-group-name WordPress_DG
```
Salida:
```
{
"deploymentGroupInfo": {
"applicationName": "WordPress_App",
"autoScalingGroups": [
"CodeDeployDemo-ASG"
],
"deploymentConfigName": "CodeDeployDefault.OneAtATime",
"ec2TagFilters": [
{
"Type": "KEY_AND_VALUE",
"Value": "CodeDeployDemo",
"Key": "Name"
}
],
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployDemoRole",
"deploymentGroupName": "WordPress_DG"
}
}
```
+ Para obtener más información sobre la API, consulte [GetDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-group.html)la *Referencia de AWS CLI comandos*.
### `get-deployment-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-instance`.
**AWS CLI**
**Obtención de información acerca de una instancia de implementación**
En el siguiente ejemplo de `get-deployment-instance`, se muestra información sobre una instancia de implementación que está asociada a la implementación especificada.
```
aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX
```
Salida:
```
{
"instanceSummary": {
"instanceId": "arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-902e9fEX",
"lifecycleEvents": [
{
"status": "Succeeded",
"endTime": 1408480726.569,
"startTime": 1408480726.437,
"lifecycleEventName": "ApplicationStop"
},
{
"status": "Succeeded",
"endTime": 1408480728.016,
"startTime": 1408480727.665,
"lifecycleEventName": "DownloadBundle"
},
{
"status": "Succeeded",
"endTime": 1408480729.744,
"startTime": 1408480729.125,
"lifecycleEventName": "BeforeInstall"
},
{
"status": "Succeeded",
"endTime": 1408480730.979,
"startTime": 1408480730.844,
"lifecycleEventName": "Install"
},
{
"status": "Failed",
"endTime": 1408480732.603,
"startTime": 1408480732.1,
"lifecycleEventName": "AfterInstall"
},
{
"status": "Skipped",
"endTime": 1408480732.606,
"lifecycleEventName": "ApplicationStart"
},
{
"status": "Skipped",
"endTime": 1408480732.606,
"lifecycleEventName": "ValidateService"
}
],
"deploymentId": "d-QA4G4F9EX",
"lastUpdatedAt": 1408480733.152,
"status": "Failed"
}
}
```
+ Para obtener más información sobre la API, consulte [GetDeploymentInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-instance.html)la *Referencia de AWS CLI comandos*.
### `get-deployment-target`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-target`.
**AWS CLI**
**Obtención de información sobre un destino de implementación**
En el siguiente ejemplo de `get-deployment-target`, se obtiene información sobre un destino de implementación que está asociado a la implementación especificada.
```
aws deploy get-deployment-target \
--deployment-id "d-A1B2C3111" \
--target-id "i-a1b2c3d4e5f611111"
```
Salida:
```
{
"deploymentTarget": {
"deploymentTargetType": "InstanceTarget",
"instanceTarget": {
"lastUpdatedAt": 1556918687.504,
"targetId": "i-a1b2c3d4e5f611111",
"targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-a1b2c3d4e5f611111",
"status": "Succeeded",
"lifecycleEvents": [
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "ApplicationStop",
"startTime": 1556918592.162,
"endTime": 1556918592.247
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "DownloadBundle",
"startTime": 1556918593.193,
"endTime": 1556918593.981
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "BeforeInstall",
"startTime": 1556918594.805,
"endTime": 1556918681.807
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "Install",
"startTime": 1556918682.696,
"endTime": 1556918683.005
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "AfterInstall",
"startTime": 1556918684.135,
"endTime": 1556918684.216
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "ApplicationStart",
"startTime": 1556918685.211,
"endTime": 1556918685.295
},
{
"status": "Succeeded",
"diagnostics": {
"errorCode": "Success",
"message": "Succeeded",
"logTail": "",
"scriptName": ""
},
"lifecycleEventName": "ValidateService",
"startTime": 1556918686.65,
"endTime": 1556918686.747
}
],
"deploymentId": "d-A1B2C3111"
}
}
}
```
Para obtener más información, consulta [GetDeploymentTarget](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentTarget.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [GetDeploymentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-target.html)la *Referencia de AWS CLI comandos*.
### `get-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment`.
**AWS CLI**
**Para obtener información acerca de una implementación**
En el siguiente `get-deployment` ejemplo, se muestra información sobre una implementación asociada a la AWS cuenta del usuario.
```
aws deploy get-deployment --deployment-id d-A1B2C3123
```
Salida:
```
{
"deploymentInfo": {
"applicationName": "WordPress_App",
"status": "Succeeded",
"deploymentOverview": {
"Failed": 0,
"InProgress": 0,
"Skipped": 0,
"Succeeded": 1,
"Pending": 0
},
"deploymentConfigName": "CodeDeployDefault.OneAtATime",
"creator": "user",
"description": "My WordPress app deployment",
"revision": {
"revisionType": "S3",
"s3Location": {
"bundleType": "zip",
"eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"",
"bucket": "amzn-s3-demo-bucket",
"key": "WordPressApp.zip"
}
},
"deploymentId": "d-A1B2C3123",
"deploymentGroupName": "WordPress_DG",
"createTime": 1409764576.589,
"completeTime": 1409764596.101,
"ignoreApplicationStopFailures": false
}
}
```
+ Para obtener más información sobre la API, consulte [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment.html)la *Referencia de AWS CLI comandos*.
### `get-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-on-premises-instance`.
**AWS CLI**
**Obtención de información sobre una instancia en las instalaciones**
En el siguiente ejemplo de `get-on-premises-instance`, se obtiene información sobre la instancia en las instalaciones especificada.
```
aws deploy get-on-premises-instance --instance-name AssetTag12010298EX
```
Salida:
```
{
"instanceInfo": {
"iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX",
"tags": [
{
"Value": "CodeDeployDemo-OnPrem",
"Key": "Name"
}
],
"instanceName": "AssetTag12010298EX",
"registerTime": 1425579465.228,
"instanceArn": "arn:aws:codedeploy:us-east-1:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh"
}
}
```
+ Para obtener más información sobre la API, consulte [GetOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-on-premises-instance.html)la *Referencia de AWS CLI comandos*.
### `install`
En el siguiente ejemplo de código, se muestra cómo utilizar `install`.
**AWS CLI**
**Instalación de una instancia en las instalaciones**
En el siguiente `install` ejemplo, se copia el archivo de configuración local de la ubicación especificada de la instancia a la ubicación de la instancia en la que el AWS CodeDeploy agente espera encontrarlo. También instala el AWS CodeDeploy agente en la instancia. No crea ningún usuario de IAM, ni registra la instancia local ni asocia ninguna etiqueta de instancia local a la instancia. AWS CodeDeploy AWS CodeDeploy
```
aws deploy install \
--override-config \
--config-file C:\temp\codedeploy.onpremises.yml \
--region us-west-2 \
--agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi
```
Salida:
```
Creating the on-premises instance configuration file... DONE
Installing the AWS CodeDeploy Agent... DONE
```
+ Para obtener información sobre la API, consulte [Install](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/install.html) en la *Referencia de comandos de la AWS CLI *.
### `list-application-revisions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-application-revisions`.
**AWS CLI**
**Obtención de información sobre las revisiones de la aplicación**
En el siguiente ejemplo de `list-application-revisions`, se muestra información sobre todas las revisiones de la aplicación que están asociadas a la aplicación especificada.
```
aws deploy list-application-revisions \
--application-name WordPress_App \
--s-3-bucket amzn-s3-demo-bucket \
--deployed exclude \
--s-3-key-prefix WordPress_ \
--sort-by lastUsedTime \
--sort-order descending
```
Salida:
```
{
"revisions": [
{
"revisionType": "S3",
"s3Location": {
"version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE",
"bucket": "amzn-s3-demo-bucket",
"key": "WordPress_App.zip",
"bundleType": "zip"
}
},
{
"revisionType": "S3",
"s3Location": {
"version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE",
"bucket": "amzn-s3-demo-bucket",
"key": "WordPress_App_2-0.zip",
"bundleType": "zip"
}
}
]
}
```
+ *Para obtener más información sobre la API, consulta la Referencia de [ListApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-application-revisions.html)comandos AWS CLI .*
### `list-applications`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-applications`.
**AWS CLI**
**Obtención de información sobre las aplicaciones**
En el siguiente `list-applications` ejemplo, se muestra información sobre todas las aplicaciones asociadas a la AWS cuenta del usuario.
```
aws deploy list-applications
```
Salida:
```
{
"applications": [
"WordPress_App",
"MyOther_App"
]
}
```
+ Para obtener más información sobre la API, consulte [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-applications.html)la *Referencia de AWS CLI comandos*.
### `list-deployment-configs`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-configs`.
**AWS CLI**
**Obtención de información acerca de las configuraciones de implementación**
En el siguiente `list-deployment-configs` ejemplo, se muestra información sobre todas las configuraciones de despliegue asociadas a la AWS cuenta del usuario.
```
aws deploy list-deployment-configs
```
Salida:
```
{
"deploymentConfigsList": [
"ThreeQuartersHealthy",
"CodeDeployDefault.AllAtOnce",
"CodeDeployDefault.HalfAtATime",
"CodeDeployDefault.OneAtATime"
]
}
```
+ Para obtener más información sobre la API, consulte [ListDeploymentConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-configs.html)la *Referencia de AWS CLI comandos*.
### `list-deployment-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-groups`.
**AWS CLI**
**Obtención de información acerca de los grupos de implementación**
En el siguiente ejemplo de `list-deployment-groups`, se muestra información sobre todos los grupos de implementación que están asociados a la aplicación especificada.
```
aws deploy list-deployment-groups --application-name WordPress_App
```
Salida:
```
{
"applicationName": "WordPress_App",
"deploymentGroups": [
"WordPress_DG",
"WordPress_Beta_DG"
]
}
```
+ Para obtener más información sobre la API, consulte [ListDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-groups.html)la *Referencia de AWS CLI comandos*.
### `list-deployment-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-instances`.
**AWS CLI**
**Obtención de información acerca de instancias de implementación**
En el siguiente ejemplo de `list-deployment-instances`, se muestra información sobre todas las instancias de implementación que están asociadas a la implementación especificada.
```
aws deploy list-deployment-instances \
--deployment-id d-A1B2C3111 \
--instance-status-filter Succeeded
```
Salida:
```
{
"instancesList": [
"i-EXAMPLE11",
"i-EXAMPLE22"
]
}
```
+ Para obtener más información sobre la API, consulte [ListDeploymentInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-instances.html)la *Referencia de AWS CLI comandos*.
### `list-deployment-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-targets`.
**AWS CLI**
**Para recuperar una lista de IDs los objetivos asociados a una implementación**
En el siguiente `list-deployment-targets` ejemplo, se recupera una lista de objetivos IDs asociados a las implementaciones que tienen el estado «Fallido» o «». InProgress
```
aws deploy list-deployment-targets \
--deployment-id "d-A1B2C3111" \
--target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}"
```
Salida:
```
{
"targetIds": [
"i-0f1558aaf90e5f1f9"
]
}
```
Para obtener más información, consulta [ListDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentTargets.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte la Referencia [ListDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-targets.html)de *AWS CLI comandos*.
### `list-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployments`.
**AWS CLI**
**Obtención de información acerca de las implementaciones**
En el siguiente ejemplo de `list-deployments`, se muestra información sobre todas las implementaciones que están asociadas al grupo de implementación.
```
aws deploy list-deployments \
--application-name WordPress_App \
--create-time-range start=2014-08-19T00:00:00,end=2014-08-20T00:00:00 \
--deployment-group-name WordPress_DG \
--include-only-statuses Failed
```
Salida:
```
{
"deployments": [
"d-EXAMPLE11",
"d-EXAMPLE22",
"d-EXAMPLE33"
]
}
```
+ Para obtener más información sobre la API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployments.html)la *Referencia de AWS CLI comandos*.
### `list-git-hub-account-token-names`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-git-hub-account-token-names`.
**AWS CLI**
**Para ver una lista de los nombres de las conexiones almacenadas a GitHub las cuentas**
En el siguiente `list-git-hub-account-token-names` ejemplo, se muestran los nombres de las conexiones almacenadas a GitHub las cuentas del AWS usuario actual.
```
aws deploy list-git-hub-account-token-names
```
Salida:
```
{
"tokenNameList": [
"my-first-token",
"my-second-token",
"my-third-token"
]
}
```
Para obtener más información, consulta [ListGitHubAccountTokenNames](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListGitHubAccountTokenNames.html) en la *AWS CodeDeploy Referencia de la API de *.
+ Para obtener más información sobre la API, consulte [ListGitHubAccountTokenNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-git-hub-account-token-names.html)la *Referencia de AWS CLI comandos*.
### `list-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-on-premises-instances`.
**AWS CLI**
**Obtención de información acerca de una o varias instancias en las instalaciones**
En el siguiente `list-on-premises-instances` ejemplo, se recupera una lista de los nombres de instancias locales disponibles para las instancias que están registradas AWS CodeDeploy y que también tienen la etiqueta de instancia local especificada asociada a la AWS CodeDeploy instancia.
```
aws deploy list-on-premises-instances \
--registration-status Registered \
--tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE
```
Salida:
```
{
"instanceNames": [
"AssetTag12010298EX"
]
}
```
+ *Para obtener información sobre la API, consulta la Referencia de [ListOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-on-premises-instances.html)comandos AWS CLI .*
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas de un recurso (aplicación)**
En el siguiente `list-tags-for-resource` ejemplo, se enumeran las etiquetas aplicadas a una aplicación denominada TestApp in CodeDeploy.
```
aws deploy list-tags-for-resource \
--resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp
```
Salida:
```
{
"Tags": [
{
"Key": "Type",
"Value": "testType"
},
{
"Key": "Name",
"Value": "testName"
}
]
}
```
Para obtener más información, consulte [Etiquetar instancias para grupos de implementación CodeDeploy en](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) la Guía del *AWS CodeDeploy usuario*.
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `push`
En el siguiente ejemplo de código, se muestra cómo utilizar `push`.
**AWS CLI**
**Para empaquetar e implementar una revisión de aplicación AWS CodeDeploy compatible en Amazon S3**
En el siguiente ejemplo de `push`, se agrupa e implementa una revisión de la aplicación en Amazon S3 y, a continuación, se asocia la revisión de la aplicación a la aplicación especificada.
```
aws deploy push \
--application-name WordPress_App \
--description "This is my deployment" \
--ignore-hidden-files \
--s3-location s3://amzn-s3-demo-bucket/WordPressApp.zip \
--source /tmp/MyLocalDeploymentFolder/
```
La salida describe cómo utilizar el comando `create-deployment` para crear una implementación que utilice la revisión de la aplicación cargada.
```
To deploy with this revision, run:
aws deploy create-deployment --application-name WordPress_App --deployment-config-name --deployment-group-name --s3-location bucket=amzn-s3-demo-bucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8EXAMPLE50a6e71fdb88EXAMPLE",version=LFsJAUdEXAMPLEfvKtvi79L8EXAMPLE
```
+ Para obtener información sobre la API, consulte [Push](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/push.html) en la *Referencia de comandos de la AWS CLI *.
### `register-application-revision`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-application-revision`.
**AWS CLI**
**Registro de información sobre una revisión de aplicación ya cargada**
El siguiente `register-application-revision` ejemplo registra información sobre una revisión de aplicación ya cargada almacenada en Amazon S3 con. AWS CodeDeploy
```
aws deploy register-application-revision \
--application-name WordPress_App \
--description "Revised WordPress application" \
--s3-location bucket=amzn-s3-demo-bucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLE
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte la Referencia [RegisterApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-application-revision.html)de *AWS CLI comandos*.
### `register-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-on-premises-instance`.
**AWS CLI**
**Para registrar una instancia en las instalaciones**
En el siguiente `register-on-premises-instance` ejemplo, se registra una instancia local con AWS CodeDeploy. No crea el usuario de IAM especificado ni asocia en AWS CodeDeploy ninguna instancia local etiquetas a la instancia registrada.
```
aws deploy register-on-premises-instance \
--instance-name AssetTag12010298EX \
--iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulta la Referencia [RegisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-on-premises-instance.html)de *AWS CLI comandos*.
### `register`
En el siguiente ejemplo de código, se muestra cómo utilizar `register`.
**AWS CLI**
**Para registrar una instancia en las instalaciones**
En el siguiente `register` ejemplo, se registra una instancia local AWS CodeDeploy, se asocia AWS CodeDeploy la etiqueta de instancia local especificada a la instancia registrada y se crea un archivo de configuración local que se puede copiar en la instancia. No crea el usuario de IAM ni instala el AWS CodeDeploy agente en la instancia.
```
aws deploy register \
--instance-name AssetTag12010298EX \
--iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem \
--tags Key=Name,Value=CodeDeployDemo-OnPrem \
--region us-west-2
```
Salida:
```
Registering the on-premises instance... DONE
Adding tags to the on-premises instance... DONE
Copy the on-premises configuration file named codedeploy.onpremises.yml to the on-premises instance, and run the following command on the on-premises instance to install and configure the AWS CodeDeploy Agent:
aws deploy install --config-file codedeploy.onpremises.yml
```
+ Para obtener información sobre la API, consulte [Register](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register.html) en la *Referencia de comandos de la AWS CLI *.
### `remove-tags-from-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-tags-from-on-premises-instances`.
**AWS CLI**
**Eliminación de etiquetas de una o más instancias en las instalaciones**
En el siguiente `remove-tags-from-on-premises-instances` ejemplo, se desasocian las etiquetas locales especificadas de las instancias AWS CodeDeploy locales. No anula el registro de las instancias locales AWS CodeDeploy, ni desinstala el AWS CodeDeploy agente de la instancia, ni elimina el archivo de configuración local de las instancias, ni elimina a los usuarios de IAM asociados a las instancias.
```
aws deploy remove-tags-from-on-premises-instances \
--instance-names AssetTag12010298EX AssetTag23121309EX \
--tags Key=Name,Value=CodeDeployDemo-OnPrem
```
Este comando no genera ninguna salida.
+ *Para obtener más información sobre la API, consulte la Referencia de comandos. [RemoveTagsFromOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/remove-tags-from-on-premises-instances.html)AWS CLI *
### `stop-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-deployment`.
**AWS CLI**
**Reintento de detener una implementación**
En el siguiente `stop-deployment` ejemplo, se intenta detener una implementación en curso que está asociada a la AWS cuenta del usuario.
aws deploy stop-deployment --deployment-id d-A1B2C3111
Salida:
```
{
"status": "Succeeded",
"statusMessage": "No more commands will be scheduled for execution in the deployment instances"
}
```
+ Para obtener más información sobre la API, consulte [StopDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/stop-deployment.html)la *Referencia de AWS CLI comandos*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Etiquetado de un recurso (aplicación)**
En el siguiente `tag-resource` ejemplo, se agregan dos etiquetas con las claves Nombre y Tipo y los valores TestName y TestType a una aplicación denominada TestApp in. CodeDeploy :
```
aws deploy tag-resource \
--resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
--tags Key=Name,Value=testName Key=Type,Value=testType
```
Si se ejecuta correctamente, este comando no genera ninguna salida.
Para obtener más información, consulte [Etiquetar instancias para grupos de implementación CodeDeploy en](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) la *Guía del AWS CodeDeploy usuario*.
+ Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `uninstall`
En el siguiente ejemplo de código, se muestra cómo utilizar `uninstall`.
**AWS CLI**
**Desinstalación de una instancia en las instalaciones**
En el siguiente `uninstall` ejemplo, se desinstala el AWS CodeDeploy agente de la instancia local y se elimina el archivo de configuración local de la instancia. No anula el registro de la instancia ni desasocia ninguna etiqueta de instancia local de la instancia, ni elimina el AWS CodeDeploy usuario de IAM asociado a la instancia. AWS CodeDeploy
```
aws deploy uninstall
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [Uninstall](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/uninstall.html) en la *Referencia de comandos de la AWS CLI *.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Eliminación de etiquetas de un recurso (aplicación)**
En el siguiente `untag-resource` ejemplo, se eliminan dos etiquetas con las claves Nombre y Tipo de una aplicación denominada TestApp in. CodeDeploy
```
aws deploy untag-resource \
--resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
--tag-keys Name Type
```
Si se ejecuta correctamente, este comando no genera ninguna salida.
Para obtener más información, consulte [Etiquetar instancias para grupos de implementación CodeDeploy en](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) la Guía del *AWS CodeDeploy usuario*.
+ Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/untag-resource.html)la *Referencia de AWS CLI comandos*.
### `update-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-application`.
**AWS CLI**
**Cambio de los detalles de una aplicación**
En el siguiente `update-application` ejemplo, se cambia el nombre de una aplicación que está asociada a la AWS cuenta del usuario.
```
aws deploy update-application \
--application-name WordPress_App \
--new-application-name My_WordPress_App
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-application.html)la *Referencia de AWS CLI comandos*.
### `update-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-deployment-group`.
**AWS CLI**
**Cambio de la información acerca de un grupo de implementación**
En el siguiente ejemplo de `update-deployment-group`, se cambia la configuración de un grupo de implementación que está asociado a la aplicación especificada.
```
aws deploy update-deployment-group \
--application-name WordPress_App \
--auto-scaling-groups My_CodeDeployDemo_ASG \
--current-deployment-group-name WordPress_DG \
--deployment-config-name CodeDeployDefault.AllAtOnce \
--ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo \
--new-deployment-group-name My_WordPress_DepGroup \
--service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [UpdateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-deployment-group.html)la *Referencia de AWS CLI comandos*.