# AWS RAM Exemplos do usando a AWS CLI
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 AWS RAM.
*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
### `accept-resource-share-invitation`
O código de exemplo a seguir mostra como usar `accept-resource-share-invitation`.
**AWS CLI**
**Como aceitar um convite de compartilhamento de recursos**
O exemplo `accept-resource-share-invitation` a seguir aceita o convite de compartilhamento de recursos especificado. As entidades principais da conta convidada podem começar imediatamente a usar os recursos do compartilhamento.
```
aws ram accept-resource-share-invitation \
--resource-share-invitation-arn arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE
```
Resultado:
```
{
"resourceShareInvitation": {
"resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
"resourceShareName": "MyLicenseShare",
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
"senderAccountId": "111111111111",
"receiverAccountId": "222222222222",
"invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
"status": "ACCEPTED"
}
}
```
+ Para ver detalhes da API, consulte [AcceptResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/accept-resource-share-invitation.html) na *Referência de comandos da AWS CLI*.
### `associate-resource-share-permission`
O código de exemplo a seguir mostra como usar `associate-resource-share-permission`.
**AWS CLI**
**Como associar uma permissão a um compartilhamento de recursos**
O exemplo `associate-resource-share-permission` a seguir substitui a permissão gerenciada existente para o tipo de recurso relevante pela permissão gerenciada especificada. O acesso a todos os recursos do tipo de recurso relevante é regido pela nova permissão.
```
aws ram associate-resource-share-permission \
--permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite \
--replace \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE
```
Resultado:
```
{
"returnValue": true
}
```
+ Para ver detalhes da API, consulte [AssociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share-permission.html) na *Referência de comandos da AWS CLI*.
### `associate-resource-share`
O código de exemplo a seguir mostra como usar `associate-resource-share`.
**AWS CLI**
**Exemplo 1: associar um recurso a um compartilhamento de recursos**
O exemplo `associate-resource-share` a seguir adiciona uma configuração de licença ao compartilhamento de recursos especificado.
```
aws ram associate-resource-share \
--resource-share arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
--resource-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE
```
Resultado:
```
{
"resourceShareAssociations": [
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
"associatedEntity": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
"associationType": "RESOURCE",
"status": "ASSOCIATING",
"external": false
}
]
}
```
**Exemplo 2: associar uma entidade principal a um compartilhamento de recursos**
O exemplo `associate-resource-share` a seguir concede acesso ao compartilhamento de recursos especificado a todas as contas na unidade organizacional especificada.
```
aws ram associate-resource-share \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
--principals arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE
```
Resultado:
```
{
"resourceShareAssociations": [
{
"status": "ASSOCIATING",
"associationType": "PRINCIPAL",
"associatedEntity": "arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE",
"external": false,
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE"
}
]
}
```
+ Para ver detalhes da API, consulte [AssociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share.html) na *Referência de comandos da AWS CLI*.
### `create-resource-share`
O código de exemplo a seguir mostra como usar `create-resource-share`.
**AWS CLI**
**Exemplo 1: criar um compartilhamento de recursos**
O exemplo `create-resource-share` a seguir cria um compartilhamento de recursos vazio com o nome especificado. É necessário adicionar separadamente recursos, entidades principais e permissões ao compartilhamento.
```
aws ram create-resource-share \
--name MyNewResourceShare
```
Resultado:
```
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
"name": "MyNewResourceShare",
"owningAccountId": "123456789012",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"creationTime": 1634586271.302,
"lastUpdatedTime": 1634586271.302
}
}
```
**Exemplo 2: criar um compartilhamento de recursos com AWS contas como entidades principais**
O exemplo `create-resource-share` a seguir cria um compartilhamento de recursos e concede acesso à conta da AWS especificada (222222222222). Se as entidades principais especificadas não fizerem parte da mesma AWS Organization, os convites serão enviados e deverão ser aceitos antes que o acesso seja concedido.
```
aws ram create-resource-share \
--name MyNewResourceShare \
--principals 222222222222
```
**Exemplo 3: criar um compartilhamento de recursos restrito à sua AWS Organization**
O exemplo `create-resource-share` a seguir cria um compartilhamento de recursos restrito às contas da AWS Organization da qual sua conta é membro e adiciona a OU especificada como entidade principal. Todas as contas nessa OU podem usar os recursos no compartilhamento de recursos.
```
aws ram create-resource-share \
--name MyNewResourceShare \
--no-allow-external-principals \
--principals arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE
```
Resultado:
```
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
"name": "MyNewResourceShare",
"owningAccountId": "123456789012",
"allowExternalPrincipals": false,
"status": "ACTIVE",
"creationTime": 1634587042.49,
"lastUpdatedTime": 1634587042.49
}
}
```
+ Para ver detalhes da API, consulte [CreateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/create-resource-share.html) na *Referência de comandos da AWS CLI*.
### `delete-resource-share`
O código de exemplo a seguir mostra como usar `delete-resource-share`.
**AWS CLI**
**Para excluir um compartilhamento de recursos**
O exemplo `delete-resource-share` a seguir exclui o compartilhamento de recursos especificado.
```
aws ram delete-resource-share \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
A seguinte saída indica sucesso:
```
{
"returnValue": true
}
```
+ Para ver detalhes da API, consulte [DeleteResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/delete-resource-share.html) na *Referência de comandos da AWS CLI*.
### `disassociate-resource-share-permission`
O código de exemplo a seguir mostra como usar `disassociate-resource-share-permission`.
**AWS CLI**
**Para remover uma permissão gerenciada por RAM para um tipo de recurso de um compartilhamento de recursos**
O exemplo `disassociate-resource-share-permission` a seguir remove a permissão de gerenciamento por RAM para bancos de dados Glue do compartilhamento de recursos especificado.
```
aws ram disassociate-resource-share-permission \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
--permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite
```
Resultado:
```
{
"returnValue": true
}
```
+ Para ver detalhes da API, consulte [DisassociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share-permission.html) na *Referência de comandos da AWS CLI*.
### `disassociate-resource-share`
O código de exemplo a seguir mostra como usar `disassociate-resource-share`.
**AWS CLI**
**Para remover um recurso de um compartilhamento de recursos**
O exemplo `disassociate-resource-share` a seguir remove o recurso especificado, nesse caso uma sub-rede VPC, do compartilhamento de recursos especificado. Qualquer entidade principal com acesso ao compartilhamento de recursos não pode mais realizar operações nesse recurso.
```
aws ram disassociate-resource-share \
--resource-arns arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Resultado:
```
{
"resourceShareAssociations": [
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"associatedEntity": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE",
"associationType": "RESOURCE",
"status": "DISASSOCIATING",
"external": false
]
}
```
+ Para ver detalhes da API, consulte [DisassociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share.html) na *Referência de comandos da AWS CLI*.
### `enable-sharing-with-aws-organization`
O código de exemplo a seguir mostra como usar `enable-sharing-with-aws-organization`.
**AWS CLI**
**Como ativar o compartilhamento de recursos entre AWS Organizations**.
O exemplo `enable-sharing-with-aws-organization` a seguir permite o compartilhamento de recursos em sua organização e unidades organizacionais.
```
aws ram enable-sharing-with-aws-organization
```
A seguinte saída indica sucesso.
```
{
"returnValue": true
}
```
+ Para ver detalhes da API, consulte [EnableSharingWithAwsOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/enable-sharing-with-aws-organization.html) na *Referência de comandos da AWS CLI*.
### `get-permission`
O código de exemplo a seguir mostra como usar `get-permission`.
**AWS CLI**
**Para recuperar os detalhes de uma permissão gerenciada por RAM**
O exemplo `get-permission` a seguir exibe os detalhes da versão padrão da permissão de gerenciamento por RAM especificada.
```
aws ram get-permission \
--permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase
```
Resultado:
```
{
"permission": {
"arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase",
"version": "2",
"defaultVersion": true,
"name": "AWSRAMPermissionGlueTableReadWriteForDatabase",
"resourceType": "glue:Database",
"permission": "{\"Effect\":\"Allow\",\"Action\":[\"glue:GetTable\", \"glue:UpdateTable\", \"glue:DeleteTable\", \"glue:BatchDeleteTable\", \"glue:BatchDeleteTableVersion\", \"glue:GetTableVersion\", \"glue:GetTableVersions\", \"glue:GetPartition\", \"glue:GetPartitions\", \"glue:BatchGetPartition\", \"glue:BatchCreatePartition\", \"glue:CreatePartition\", \"glue:UpdatePartition\", \"glue:BatchDeletePartition\", \"glue:DeletePartition\", \"glue:GetTables\", \"glue:SearchTables\"]}",
"creationTime": 1624912434.431,
"lastUpdatedTime": 1624912434.431,
"isResourceTypeDefault": false
}
}
```
+ Para ver detalhes da API, consulte [GetPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-permission.html) na *Referência de comandos da AWS CLI*.
### `get-resource-policies`
O código de exemplo a seguir mostra como usar `get-resource-policies`.
**AWS CLI**
**Para obter as políticas de um recurso**
O exemplo `get-resource-policies` a seguir exibe as políticas de permissão baseadas em recursos para o recurso especificado associado a um compartilhamento de recursos.
```
aws ram get-resource-policies \
--resource-arns arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE
```
Resultado:
```
{
"policies": [
"{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"RamStatement1\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[]},\"Action\":[\"ec2:RunInstances\",\"ec2:CreateNetworkInterface\",\"ec2:DescribeSubnets\"],\"Resource\":\"arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE\"}]}"
]
}
```
+ Para receber detalhes da API, consulte [GetResourcePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-policies.html) na *Referência de comandos da AWS CLI*.
### `get-resource-share-associations`
O código de exemplo a seguir mostra como usar `get-resource-share-associations`.
**AWS CLI**
**Exemplo 1: listar todas as associações de recursos para todos os tipos de recursos**
O exemplo `get-resource-share-associations` a seguir lista as associações de recursos para todos os tipos de recursos em todos os seus compartilhamentos de recursos.
```
aws ram get-resource-share-associations \
--association-type RESOURCE
```
Resultado:
```
{
"resourceShareAssociations": [
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"associatedEntity": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE",
"resourceShareName": "MySubnetShare",
"associationType": "RESOURCE",
"status": "ASSOCIATED",
"creationTime": 1565303590.973,
"lastUpdatedTime": 1565303591.695,
"external": false
},
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/8167bdfe-4480-4a01-8632-315e0EXAMPLE",
"associatedEntity": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
"resourceShareName": "MyLicenseShare",
"associationType": "RESOURCE",
"status": "ASSOCIATED",
"creationTime": 1632342958.457,
"lastUpdatedTime": 1632342958.907,
"external": false
}
]
}
```
**Exemplo 2: listar as associações da entidade principal a um compartilhamento de recursos**
O exemplo `get-resource-share-associations` a seguir lista somente as associações da entidade principal para o compartilhamento de recursos especificado.
```
aws ram get-resource-share-associations \
--resource-share-arns arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE \
--association-type PRINCIPAL
```
Resultado:
```
{
"resourceShareAssociations": [
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
"resourceShareName": "MyNewResourceShare",
"associatedEntity": "arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE",
"associationType": "PRINCIPAL",
"status": "ASSOCIATED",
"creationTime": 1634587042.49,
"lastUpdatedTime": 1634587044.291,
"external": false
}
]
}
```
+ Para ver detalhes da API, consulte [GetResourceShareAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-associations.html) na *Referência de comandos da AWS CLI*.
### `get-resource-share-invitations`
O código de exemplo a seguir mostra como usar `get-resource-share-invitations`.
**AWS CLI**
**Para listar seus convites de compartilhamento de recursos**
O exemplo `get-resource-share-invitations` a seguir lista seus convites atuais de compartilhamento de recursos.
```
aws ram get-resource-share-invitations
```
Resultado:
```
{
"resourceShareInvitations": [
{
"resourceShareInvitationArn": "arn:aws:ram:us-west2-1:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE",
"resourceShareName": "project-resource-share",
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/fcb639f0-1449-4744-35bc-a983fEXAMPLE",
"senderAccountId": "111111111111",
"receiverAccountId": "222222222222",
"invitationTimestamp": 1565312166.258,
"status": "PENDING"
}
]
}
```
+ Para ver detalhes da API, consulte [GetResourceShareInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-invitations.html) na *Referência de comandos da AWS CLI*.
### `get-resource-shares`
O código de exemplo a seguir mostra como usar `get-resource-shares`.
**AWS CLI**
**Exemplo 1: listar compartilhamentos de recursos possuídos e compartilhados**
O exemplo `get-resource-shares` a seguir lista os compartilhamentos de recursos que foram criados e estão sendo compartilhados.
```
aws ram get-resource-shares \
--resource-owner SELF
```
Resultado:
```
{
"resourceShares": [
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/3ab63985-99d9-1cd2-7d24-75e93EXAMPLE",
"name": "my-resource-share",
"owningAccountId": "123456789012",
"allowExternalPrincipals": false,
"status": "ACTIVE",
"tags": [
{
"key": "project",
"value": "lima"
}
]
"creationTime": 1565295733.282,
"lastUpdatedTime": 1565295733.282
},
{
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"name": "my-resource-share",
"owningAccountId": "123456789012",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"creationTime": 1565295733.282,
"lastUpdatedTime": 1565295733.282
}
]
}
```
**Exemplo 2: listar compartilhamentos de recursos possuídos por outros e compartilhados com você**
O exemplo `get-resource-shares` a seguir lista os compartilhamentos de recursos que foram criados por outros e estão sendo compartilhados com você. Neste exemplo, não há nenhum.
```
aws ram get-resource-shares \
--resource-owner OTHER-ACCOUNTS
```
Resultado:
```
{
"resourceShares": []
}
```
+ Para ver detalhes da API, consulte [GetResourceShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-shares.html) na *Referência de comandos da AWS CLI*.
### `list-pending-invitation-resources`
O código de exemplo a seguir mostra como usar `list-pending-invitation-resources`.
**AWS CLI**
**Para listar os recursos que estão disponíveis em um compartilhamento de recursos pendente**
O exemplo `list-pending-invitation-resources` a seguir lista todos os recursos que estão no compartilhamento de recursos associado ao convite especificado.
```
aws ram list-pending-invitation-resources \
--resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE
```
Resultado:
```
{
"resources": [
{
"arn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-04a555b0e6EXAMPLE",
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
"creationTime": 1634676051.269,
"lastUpdatedTime": 1634676052.07,
"status": "AVAILABLE",
"type": "ec2:Subnet"
},
{
"arn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"creationTime": 1624912434.431,
"lastUpdatedTime": 1624912434.431,
"status": "AVAILABLE",
"type": "license-manager:LicenseConfiguration"
}
]
}
```
+ Para ver detalhes da API, consulte [ListPendingInvitationResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-pending-invitation-resources.html) na *Referência de comandos da AWS CLI*.
### `list-permissions`
O código de exemplo a seguir mostra como usar `list-permissions`.
**AWS CLI**
**Para listar as permissões gerenciadas por RAM disponíveis**
O exemplo `list-permissions` a seguir lista todas as permissões gerenciadas por RAM disponíveis somente para o tipo de recurso de banco de dados AWS Glue.
```
aws ram list-permissions \
--resource-type glue:Database
```
Resultado:
```
{
"permissions": [
{
"arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionGlueDatabase",
"version": "1",
"defaultVersion": true,
"name": "AWSRAMDefaultPermissionGlueDatabase",
"resourceType": "glue:Database",
"creationTime": 1592007820.935,
"lastUpdatedTime": 1592007820.935,
"isResourceTypeDefault": true
},
{
"arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueAllTablesReadWriteForDatabase",
"version": "2",
"defaultVersion": true,
"name": "AWSRAMPermissionGlueAllTablesReadWriteForDatabase",
"resourceType": "glue:Database",
"creationTime": 1624912413.323,
"lastUpdatedTime": 1624912413.323,
"isResourceTypeDefault": false
},
{
"arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite",
"version": "2",
"defaultVersion": true,
"name": "AWSRAMPermissionGlueDatabaseReadWrite",
"resourceType": "glue:Database",
"creationTime": 1624912417.4,
"lastUpdatedTime": 1624912417.4,
"isResourceTypeDefault": false
},
{
"arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase",
"version": "2",
"defaultVersion": true,
"name": "AWSRAMPermissionGlueTableReadWriteForDatabase",
"resourceType": "glue:Database",
"creationTime": 1624912434.431,
"lastUpdatedTime": 1624912434.431,
"isResourceTypeDefault": false
}
]
}
```
O exemplo `list-permissions` a seguir lista todas as permissões gerenciadas por RAM disponíveis para todos os tipos de recurso.
```
aws ram list-permissions
```
Resultado:
```
{
"permissions": [
{
"arn": "arn:aws:ram::aws:permission/AWSRAMBlankEndEntityCertificateAPICSRPassthroughIssuanceCertificateAuthority",
"version": "1",
"defaultVersion": true,
"name": "AWSRAMBlankEndEntityCertificateAPICSRPassthroughIssuanceCertificateAuthority",
"resourceType": "acm-pca:CertificateAuthority",
"creationTime": 1623264861.085,
"lastUpdatedTime": 1623264861.085,
"isResourceTypeDefault": false
},
{
"arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionAppMesh",
"version": "1",
"defaultVersion": true,
"name": "AWSRAMDefaultPermissionAppMesh",
"resourceType": "appmesh:Mesh",
"creationTime": 1589307188.584,
"lastUpdatedTime": 1589307188.584,
"isResourceTypeDefault": true
},
...TRUNCATED FOR BREVITY...
{
"arn": "arn:aws:ram::aws:permission/AWSRAMSubordinateCACertificatePathLen0IssuanceCertificateAuthority",
"version": "1",
"defaultVersion": true,
"name": "AWSRAMSubordinateCACertificatePathLen0IssuanceCertificateAuthority",
"resourceType": "acm-pca:CertificateAuthority",
"creationTime": 1623264876.75,
"lastUpdatedTime": 1623264876.75,
"isResourceTypeDefault": false
}
]
}
```
+ Para ver detalhes da API, consulte [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-permissions.html) na *Referência de comandos da AWS CLI*.
### `list-principals`
O código de exemplo a seguir mostra como usar `list-principals`.
**AWS CLI**
**Para listar entidades principais com acesso a um recurso**
O exemplo `list-principals` a seguir exibe uma lista das entidades principais que podem acessar recursos do tipo especificado por meio de qualquer compartilhamento de recursos.
```
aws ram list-principals \
--resource-type ec2:Subnet
```
Resultado:
```
{
"principals": [
{
"id": "arn:aws:organizations::123456789012:ou/o-gx7EXAMPLE/ou-29c5-zEXAMPLE",
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"creationTime": 1565298209.737,
"lastUpdatedTime": 1565298211.019,
"external": false
}
]
}
```
+ Para ver detalhes da API, consulte [ListPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-principals.html) na *Referência de comandos da AWS CLI*.
### `list-resource-share-permissions`
O código de exemplo a seguir mostra como usar `list-resource-share-permissions`.
**AWS CLI**
**Para listar todas as permissões gerenciadas por RAM atualmente anexadas a um compartilhamento de recursos**
O exemplo `list-resource-share-permissions` a seguir lista todas as permissões gerenciadas por RAM anexadas ao compartilhamento de recursos especificado.
```
aws ram list-resource-share-permissions \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE
```
Resultado:
```
{
"permissions": [
{
"arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionLicenseConfiguration",
"version": "1",
"resourceType": "license-manager:LicenseConfiguration",
"status": "ASSOCIATED",
"lastUpdatedTime": 1632342984.234
},
{
"arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite",
"version": "2",
"resourceType": "glue:Database",
"status": "ASSOCIATED",
"lastUpdatedTime": 1632512462.297
}
]
}
```
+ Para ver detalhes da API, consulte [ListResourceSharePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-share-permissions.html) na *Referência de comandos da AWS CLI*.
### `list-resource-types`
O código de exemplo a seguir mostra como usar `list-resource-types`.
**AWS CLI**
**Para listar os tipos de recursos compatíveis com o AWS RAM**
O exemplo `list-resource-types` a seguir lista todos os tipos de recursos atualmente compatíveis com o AWS RAM.
```
aws ram list-resource-types
```
Resultado:
```
{
"resourceTypes": [
{
"resourceType": "route53resolver:FirewallRuleGroup",
"serviceName": "route53resolver"
},
{
"resourceType": "ec2:LocalGatewayRouteTable",
"serviceName": "ec2"
},
...OUTPUT TRUNCATED FOR BREVITY...
{
"resourceType": "ec2:Subnet",
"serviceName": "ec2"
},
{
"resourceType": "ec2:TransitGatewayMulticastDomain",
"serviceName": "ec2"
}
]
}
```
+ Para ver detalhes da API, consulte [ListResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-types.html) na *Referência de comandos da AWS CLI*.
### `list-resources`
O código de exemplo a seguir mostra como usar `list-resources`.
**AWS CLI**
**Para listar os recursos associados a um compartilhamento de recursos**
O exemplo `list-resources` a seguir lista todos os recursos no compartilhamento de recursos especificado que são do tipo especificado.
```
aws ram list-resources \
--resource-type ec2:Subnet \
--resource-owner SELF \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Resultado:
```
{
"resources": [
{
"arn": "aarn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1f4e15235",
"type": "ec2:Subnet",
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"creationTime": 1565301545.023,
"lastUpdatedTime": 1565301545.947
}
]
}
```
+ Para ver detalhes da API, consulte [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resources.html) na *Referência de comandos da AWS CLI*.
### `promote-resource-share-created-from-policy`
O código de exemplo a seguir mostra como usar `promote-resource-share-created-from-policy`.
**AWS CLI**
**Como promover um compartilhamento de recursos baseado em políticas de recursos para a funcionalidade completa no AWS RAM**
O exemplo `promote-resource-share-created-from-policy` a seguir usa um compartilhamento de recursos criado implicitamente ao anexar uma política baseada em recursos e o converte em totalmente funcional com o console do AWS RAM e suas operações de CLI e API.
```
aws ram promote-resource-share-created-from-policy \
--resource-share-arn arn:aws:ram:us-east-1:123456789012:resource-share/91fa8429-2d06-4032-909a-90909EXAMPLE
```
Resultado:
```
{
"returnValue": true
}
```
+ Para ver detalhes da API, consulte [PromoteResourceShareCreatedFromPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/promote-resource-share-created-from-policy.html) na *Referência de comandos da AWS CLI*.
### `reject-resource-share-invitation`
O código de exemplo a seguir mostra como usar `reject-resource-share-invitation`.
**AWS CLI**
**Como rejeitar um convite de compartilhamento de recursos**
O exemplo `reject-resource-share-invitation` a seguir rejeita o convite de compartilhamento de recursos especificado.
```
aws ram reject-resource-share-invitation \
--resource-share-invitation-arn arn:aws:ram:us-west-2:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE
```
Resultado:
```
"resourceShareInvitations": [
{
"resourceShareInvitationArn": "arn:aws:ram:us-west2-1:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE",
"resourceShareName": "project-resource-share",
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/fcb639f0-1449-4744-35bc-a983fEXAMPLE",
"senderAccountId": "111111111111",
"receiverAccountId": "222222222222",
"invitationTimestamp": 1565319592.463,
"status": "REJECTED"
}
]
```
+ Para ver detalhes da API, consulte [RejectResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/reject-resource-share-invitation.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Para adicionar tags a um compartilhamento de recursos**
O exemplo `tag-resource` a seguir adiciona a chave de tag `project` e o valor associado de `lima` ao compartilhamento de recursos especificado.
```
aws ram tag-resource \
--tags key=project,value=lima \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Este comando não produz saída.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover as tags de um compartilhamento de recursos**
O exemplo `untag-resource` a seguir remove a tag com uma chave de `project` e seu valor associado do compartilhamento de recursos especificado.
```
aws ram untag-resource \
--tag-keys project \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Este comando não produz saída.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-resource-share`
O código de exemplo a seguir mostra como usar `update-resource-share`.
**AWS CLI**
**Para atualizar um compartilhamento de recurso**
O exemplo `update-resource-share` a seguir altera o compartilhamento de recursos especificado para permitir entidades principais externas que não estejam em uma AWS Organization.
```
aws ram update-resource-share \
--allow-external-principals \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Resultado:
```
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"name": "my-resource-share",
"owningAccountId": "123456789012",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"creationTime": 1565295733.282,
"lastUpdatedTime": 1565303080.023
}
}
```
+ Para ver detalhes da API, consulte [UpdateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/update-resource-share.html) na *Referência de comandos da AWS CLI*.