# Exemplos do AppRegistry usando a AWS CLI
<a name="cli_service-catalog-appregistry_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AppRegistry.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `associate-attribute-group`
<a name="service-catalog-appregistry_AssociateAttributeGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `associate-attribute-group`.

**AWS CLI**  
**Para associar um grupo de atributos**  
O exemplo `associate-attribute-group` a seguir associa um grupo de atributos específico em sua conta da AWS a uma aplicação específica em sua conta da AWS.  

```
aws servicecatalog-appregistry associate-attribute-group \
    --application "ExampleApplication" \
    --attribute-group "ExampleAttributeGroup"
```
Resultado:  

```
{
    "applicationArn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
    "attributeGroupArn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl"
}
```
Para obter mais informações, consulte [Associar e desassociar grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [AssociateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/associate-attribute-group.html) na *Referência de comandos da AWS CLI*. 

### `create-application`
<a name="service-catalog-appregistry_CreateApplication_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-application`.

**AWS CLI**  
**Para criar uma aplicação**  
O exemplo `create-application` a seguir cria uma nova aplicação em sua conta da AWS.  

```
aws servicecatalog-appregistry create-application \
    --name "ExampleApplication"
```
Resultado:  

```
{
    "application": {
        "id": "0ars38r6btoohvpvd9gqrptt9l",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
        "name": "ExampleApplication",
        "creationTime": "2023-02-28T21:10:10.820000+00:00",
        "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00",
        "tags": {}
    }
}
```
Para obter mais informações, consulte [Criar aplicações](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-apps.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-application.html) na *Referência de comandos da AWS CLI*. 

### `create-attribute-group`
<a name="service-catalog-appregistry_CreateAttributeGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-attribute-group`.

**AWS CLI**  
**Para criar um grupo de atributos**  
O exemplo `create-attribute-group` a seguir cria um novo grupo de atributos em sua conta da AWS.  

```
aws servicecatalog-appregistry create-attribute-group \
    --name "ExampleAttributeGroup" \
    --attributes '{"SomeKey1":"SomeValue1","SomeKey2":"SomeValue2"}'
```
Resultado:  

```
{
    "attributeGroup": {
        "id": "01sj5xdwhbw54kejwnt09fnpcl",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
        "name": "ExampleAttributeGroup",
        "creationTime": "2023-02-28T20:38:01.389000+00:00",
        "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00",
        "tags": {}
    }
}
```
Para obter mais informações, consulte [Criar grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-attr-groups.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [CreateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-attribute-group.html) na *Referência de comandos da AWS CLI*. 

### `delete-application`
<a name="service-catalog-appregistry_DeleteApplication_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-application`.

**AWS CLI**  
**Como excluir uma aplicação do**  
O exemplo `delete-application` a seguir exclui uma aplicação específico da sua conta da AWS.  

```
aws servicecatalog-appregistry delete-application \
    --application "ExampleApplication3"
```
Resultado:  

```
{
    "application": {
        "id": "055gw7aynr1i5mbv7kjwzx5945",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945",
        "name": "ExampleApplication3",
        "creationTime": "2023-02-28T22:06:28.228000+00:00",
        "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00"
    }
}
```
Para obter mais informações, consulte [Excluir aplicações](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-app-details.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-application.html) na *Referência de comandos da AWS CLI*. 

### `delete-attribute-group`
<a name="service-catalog-appregistry_DeleteAttributeGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-attribute-group`.

**AWS CLI**  
**Exemplo 8: excluir um grupo de atributos**  
O exemplo `delete-attribute-group` a seguir exclui um grupo de atributos específico em sua conta da AWS.  

```
aws servicecatalog-appregistry delete-attribute-group \
    --attribute-group "ExampleAttributeGroup3"
```
Resultado:  

```
{
    "attributeGroup": {
        "id": "011ge6y3emyjijt8dw8jn6r0hv",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv",
        "name": "ExampleAttributeGroup3",
        "creationTime": "2023-02-28T22:05:35.224000+00:00",
        "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00"
    }
}
```
Para obter mais informações, consulte [Excluir grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-attr-group.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [DeleteAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-attribute-group.html) na *Referência de comandos da AWS CLI*. 

### `get-application`
<a name="service-catalog-appregistry_GetApplication_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-application`.

**AWS CLI**  
**Para obter uma aplicação**  
O exemplo `get-application` a seguir recupera informações de metadados sobre uma aplicação específica em sua conta da AWS.  

```
aws servicecatalog-appregistry get-application \
    --application "ExampleApplication"
```
Resultado:  

```
{
    "id": "0ars38r6btoohvpvd9gqrptt9l",
    "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
    "name": "ExampleApplication",
    "creationTime": "2023-02-28T21:10:10.820000+00:00",
    "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00",
    "associatedResourceCount": 0,
    "tags": {
        "aws:servicecatalog:applicationName": "ExampleApplication"
    },
    "integrations": {
        "resourceGroup": {
            "state": "CREATE_COMPLETE",
            "arn": "arn:aws:resource-groups:us-west-2:813737243517:group/AWS_AppRegistry_Application-ExampleApplication"
        }
    }
}
```
Para obter mais informações, consulte [Usar detalhes de aplicações](https://docs.aws.amazon.com/servicecatalog/latest/arguide/access-app-details.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-application.html) na *Referência de comandos da AWS CLI*. 

### `get-attribute-group`
<a name="service-catalog-appregistry_GetAttributeGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-attribute-group`.

**AWS CLI**  
**Para obter um grupo de atributos**  
O exemplo `get-attribute-group` a seguir recupera um grupo de atributos específico em sua conta da AWS.  

```
aws servicecatalog-appregistry get-attribute-group \
    --attribute-group "ExampleAttributeGroup"
```
Resultado:  

```
{
    "id": "01sj5xdwhbw54kejwnt09fnpcl",
    "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
    "name": "ExampleAttributeGroup",
    "attributes": "{\"SomeKey1\":\"SomeValue1\",\"SomeKey2\":\"SomeValue2\"}",
    "creationTime": "2023-02-28T20:38:01.389000+00:00",
    "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00",
    "tags": {
        "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup"
    }
}
```
Para obter mais informações, consulte [Gerenciar metadados em grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/manage-metatdata.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [GetAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-attribute-group.html) na *Referência de comandos da AWS CLI*. 

### `list-applications`
<a name="service-catalog-appregistry_ListApplications_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-applications`.

**AWS CLI**  
**Para listar aplicações**  
O exemplo `list-applications` a seguir recupera uma lista de todos as aplicações em sua conta da AWS.  

```
aws servicecatalog-appregistry list-applications
```
Resultado:  

```
{
    "applications": [
        {
            "id": "03axw94pjfj3uan00tcgbrxnkw",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/03axw94pjfj3uan00tcgbrxnkw",
            "name": "ExampleApplication2",
            "creationTime": "2023-02-28T21:59:34.094000+00:00",
            "lastUpdateTime": "2023-02-28T21:59:34.094000+00:00"
        },
        {
            "id": "055gw7aynr1i5mbv7kjwzx5945",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945",
            "name": "ExampleApplication3",
            "creationTime": "2023-02-28T22:06:28.228000+00:00",
            "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00"
        },
        {
            "id": "0ars38r6btoohvpvd9gqrptt9l",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
            "name": "ExampleApplication",
            "description": "This is an example application",
            "creationTime": "2023-02-28T21:10:10.820000+00:00",
            "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00"
        }
    ]
}
```
Para obter mais informações, consulte [Visualizar detalhes de aplicações](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-app-details.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-applications.html) na *Referência de comandos da AWS CLI*. 

### `list-associated-attribute-groups`
<a name="service-catalog-appregistry_ListAssociatedAttributeGroups_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-associated-attribute-groups`.

**AWS CLI**  
**Para listar grupos de atributos associados**  
O exemplo `list-associated-attribute-groups` a seguir recupera uma lista de todos os grupos de atributos em sua conta da AWS que estão associados a uma aplicação específica em sua conta da AWS.  

```
aws servicecatalog-appregistry list-associated-attribute-groups \
    --application "ExampleApplication"
```
Resultado:  

```
{
    "attributeGroups": [
        "01sj5xdwhbw54kejwnt09fnpcl"
    ]
}
```
Para obter mais informações, consulte [Associar e desassociar grupos de atributos](https://https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [ListAssociatedAttributeGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-associated-attribute-groups.html) na *Referência de comandos da AWS CLI*. 

### `list-attribute-groups-for-application`
<a name="service-catalog-appregistry_ListAttributeGroupsForApplication_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-attribute-groups-for-application`.

**AWS CLI**  
**Para listar grupos de atributos para uma aplicação**  
O exemplo `list-attribute-groups-for-application` a seguir lista os detalhes de todos os grupos de atributos em sua conta da AWS que estão associados a uma aplicação específica em sua conta da AWS.  

```
aws servicecatalog-appregistry list-attribute-groups-for-application \
    --application "ExampleApplication"
```
Resultado:  

```
{
    "attributeGroupsDetails": [
        {
            "id": "01sj5xdwhbw54kejwnt09fnpcl",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
            "name": "ExampleAttributeGroup"
        }
    ]
}
```
Para obter mais informações, consulte [Visualizar detalhes do grupo de atributos](https://servicecatalog/latest/arguide/view-attr-group.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [ListAttributeGroupsForApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups-for-application.html) na *Referência de comandos da AWS CLI*. 

### `list-attribute-groups`
<a name="service-catalog-appregistry_ListAttributeGroups_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-attribute-groups`.

**AWS CLI**  
**Para listar grupos de atributos**  
O exemplo `list-attribute-groups` a seguir recupera uma lista de todos os grupos de atributos em sua conta da AWS.  

```
aws servicecatalog-appregistry list-attribute-groups
```
Resultado:  

```
{
    "attributeGroups": [
        {
            "id": "011ge6y3emyjijt8dw8jn6r0hv",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv",
            "name": "ExampleAttributeGroup3",
            "creationTime": "2023-02-28T22:05:35.224000+00:00",
            "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00"
        },
        {
            "id": "01sj5xdwhbw54kejwnt09fnpcl",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
            "name": "ExampleAttributeGroup",
            "description": "This is an example attribute group",
            "creationTime": "2023-02-28T20:38:01.389000+00:00",
            "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00"
        },
        {
            "id": "03n1yffgq6d18vwrzxf0c70nm3",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/03n1yffgq6d18vwrzxf0c70nm3",
            "name": "ExampleAttributeGroup2",
            "creationTime": "2023-02-28T21:57:30.687000+00:00",
            "lastUpdateTime": "2023-02-28T21:57:30.687000+00:00"
        }
    ]
}
```
Para obter mais informações, consulte [Visualizar detalhes do grupo de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-attr-group.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [ListAttributeGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups.html) na *Referência de comandos da AWS CLI*. 

### `update-application`
<a name="service-catalog-appregistry_UpdateApplication_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-application`.

**AWS CLI**  
**Para atualizar uma aplicação**  
O exemplo `update-application` a seguir atualiza uma aplicação específica em sua conta da AWS para incluir uma descrição.  

```
aws servicecatalog-appregistry update-application \
    --application "ExampleApplication" \
    --description "This is an example application"
```
Resultado:  

```
{
    "application": {
        "id": "0ars38r6btoohvpvd9gqrptt9l",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
        "name": "ExampleApplication",
        "description": "This is an example application",
        "creationTime": "2023-02-28T21:10:10.820000+00:00",
        "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00",
        "tags": {
            "aws:servicecatalog:applicationName": "ExampleApplication"
        }
    }
}
```
Para obter mais informações, consulte [Editar aplicações](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-apps.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-application.html) na *Referência de comandos da AWS CLI*. 

### `update-attribute-group`
<a name="service-catalog-appregistry_UpdateAttributeGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-attribute-group`.

**AWS CLI**  
**Para atualizar um grupo de atributos**  
O exemplo `update-attribute-group` a seguir atualiza um grupo de atributos específico em sua conta da AWS para incluir uma descrição.  

```
aws servicecatalog-appregistry update-attribute-group \
    --attribute-group "ExampleAttributeGroup" \
    --description "This is an example attribute group"
```
Resultado:  

```
{
    "attributeGroup": {
        "id": "01sj5xdwhbw54kejwnt09fnpcl",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
        "name": "ExampleAttributeGroup",
        "description": "This is an example attribute group",
        "creationTime": "2023-02-28T20:38:01.389000+00:00",
        "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00",
        "tags": {
            "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup"
        }
    }
}
```
Para obter mais informações, consulte [Editar grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-attr-group.html) no *Guia do administrador do AWS Service Catalog AppRegistry*.  
+  Para ver detalhes da API, consulte [UpdateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-attribute-group.html) na *Referência de comandos da AWS CLI*.