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.
# Ejemplos de código para Directory Service usar AWS SDKs
Los siguientes ejemplos de código muestran cómo usarlo AWS Directory Service con un kit de desarrollo de AWS software (SDK).
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.
**Más recursos**
+ **[Directory Service Guía de administración](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html)**: más información sobre Directory Service.
+ **[Directory Service Referencia de la API](https://docs.aws.amazon.com/directoryservice/latest/APIReference/Welcome.html)**: detalles sobre todas Directory Service las acciones disponibles.
+ **[AWS Centro para desarrolladores](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)**: ejemplos de código que puedes filtrar por categoría o por búsqueda de texto completo.
+ **[AWS Ejemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repositorio con código completo en los idiomas preferidos. Incluye instrucciones para configurar y ejecutar el código.
**Contents**
+ [Conceptos básicos](directory-service_code_examples_basics.md)
+ [Acciones](directory-service_code_examples_actions.md)
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# Ejemplos básicos de uso Directory Service AWS SDKs
Los siguientes ejemplos de código muestran cómo utilizar los conceptos básicos de AWS Directory Service with AWS SDKs.
**Contents**
+ [Acciones](directory-service_code_examples_actions.md)
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# Acciones para Directory Service usar AWS SDKs
Los siguientes ejemplos de código muestran cómo realizar Directory Service acciones individuales con AWS SDKs. Cada ejemplo incluye un enlace a GitHub, donde puede encontrar instrucciones para configurar y ejecutar el código.
Los siguientes ejemplos incluyen solo las acciones que se utilizan con mayor frecuencia. Para ver una lista completa, consulte la [Referencia de la API de AWS Directory Service](https://docs.aws.amazon.com/directoryservice/latest/APIReference/Welcome.html).
**Topics**
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# Utilizar `DescribeDirectories` con una CLI
Los siguientes ejemplos de código muestran cómo utilizar `DescribeDirectories`.
------
#### [ CLI ]
**AWS CLI**
**Obtención de información detallada acerca de sus directorios**.
En el siguiente ejemplo de `describe-directories`, se muestran los detalles del directorio especificado.
```
aws ds describe-directories \
--directory-id d-a1b2c3d4e5
```
Salida:
```
{
"DirectoryDescriptions": [
{
"DirectoryId": "d-a1b2c3d4e5",
"Name": "mydirectory.example.com",
"ShortName": "mydirectory",
"Size": "Small",
"Edition": "Standard",
"Alias": "d-a1b2c3d4e5",
"AccessUrl": "d-a1b2c3d4e5.awsapps.com",
"Stage": "Active",
"ShareStatus": "Shared",
"ShareMethod": "HANDSHAKE",
"ShareNotes": "These are my share notes",
"LaunchTime": "2019-07-08T15:33:46.327000-07:00",
"StageLastUpdatedDateTime": "2019-07-08T15:59:12.307000-07:00",
"Type": "SharedMicrosoftAD",
"SsoEnabled": false,
"DesiredNumberOfDomainControllers": 0,
"OwnerDirectoryDescription": {
"DirectoryId": "d-b2c3d4e5f6",
"AccountId": "123456789111",
"DnsIpAddrs": [
"203.113.0.248",
"203.113.0.253"
],
"VpcSettings": {
"VpcId": "vpc-a1b2c3d4",
"SubnetIds": [
"subnet-a1b2c3d4",
"subnet-d4c3b2a1"
],
"AvailabilityZones": [
"us-west-2a",
"us-west-2c"
]
}
}
}
]
}
```
+ Para obtener más información sobre la API, consulte [DescribeDirectories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-directories.html)la *Referencia de AWS CLI comandos*.
------
#### [ PowerShell ]
**Herramientas para la PowerShell versión 4**
**Ejemplo 1: Este comando obtiene información acerca de los directorios que pertenecen a esta cuenta.**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**Salida:**
```
DirectoryId Name DnsIpAddrs Type
----------- ---- ---------- ----
d-123456abcd abcd.example.com {172.31.74.189, 172.31.13.145} SimpleAD
d-123456efgh wifi.example.com {172.31.16.108, 172.31.10.56} ADConnector
d-123456ijkl lan2.example.com {172.31.10.56, 172.31.16.108} MicrosoftAD
```
+ Para obtener más información sobre la API, consulte [DescribeDirectories Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este comando obtiene información acerca de los directorios que pertenecen a esta cuenta.**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**Salida:**
```
DirectoryId Name DnsIpAddrs Type
----------- ---- ---------- ----
d-123456abcd abcd.example.com {172.31.74.189, 172.31.13.145} SimpleAD
d-123456efgh wifi.example.com {172.31.16.108, 172.31.10.56} ADConnector
d-123456ijkl lan2.example.com {172.31.10.56, 172.31.16.108} MicrosoftAD
```
+ Para obtener más información sobre la API, consulte [DescribeDirectories](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
------
# Utilizar `DescribeTrusts` con una CLI
Los siguientes ejemplos de código muestran cómo utilizar `DescribeTrusts`.
------
#### [ CLI ]
**AWS CLI**
**Obtención de detalles sobre sus relaciones de confianza**
En el siguiente ejemplo de `describe-trusts`, se muestran detalles sobre las relaciones de confianza del directorio especificado.
```
aws ds describe-trusts \
--directory-id d-a1b2c3d4e5
```
Salida:
```
{
"Trusts": [
{
"DirectoryId": "d-a1b2c3d4e5",
"TrustId": "t-9a8b7c6d5e",
"RemoteDomainName": "other.example.com",
"TrustType": "Forest",
"TrustDirection": "Two-Way",
"TrustState": "Verified",
"CreatedDateTime": "2017-06-20T18:08:45.614000-07:00",
"LastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00",
"StateLastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00",
"SelectiveAuth": "Disabled"
}
]
}
```
+ Para obtener más información sobre la API, consulte [DescribeTrusts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-trusts.html)la *Referencia de AWS CLI comandos*.
------
#### [ PowerShell ]
**Herramientas para la PowerShell versión 4**
**Ejemplo 1: Este comando obtiene la información de las relaciones de confianza creadas para el directory-id especificado.**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**Salida:**
```
CreatedDateTime : 7/5/2019 4:55:42 AM
DirectoryId : d-123456abcd
LastUpdatedDateTime : 7/5/2019 4:56:04 AM
RemoteDomainName : contoso.com
SelectiveAuth : Disabled
StateLastUpdatedDateTime : 7/5/2019 4:56:04 AM
TrustDirection : One-Way: Incoming
TrustId : t-9067157123
TrustState : Created
TrustStateReason :
TrustType : Forest
```
+ Para obtener más información sobre la API, consulte [DescribeTrusts Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este comando obtiene la información de las relaciones de confianza creadas para el directory-id especificado.**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**Salida:**
```
CreatedDateTime : 7/5/2019 4:55:42 AM
DirectoryId : d-123456abcd
LastUpdatedDateTime : 7/5/2019 4:56:04 AM
RemoteDomainName : contoso.com
SelectiveAuth : Disabled
StateLastUpdatedDateTime : 7/5/2019 4:56:04 AM
TrustDirection : One-Way: Incoming
TrustId : t-9067157123
TrustState : Created
TrustStateReason :
TrustType : Forest
```
+ Para obtener más información sobre la API, consulte [DescribeTrusts](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
------