future = getAsyncClient().attachThingPrincipal(principalRequest);
future.whenComplete((attachResponse, ex) -> {
if (attachResponse != null && attachResponse.sdkHttpResponse().isSuccessful()) {
System.out.println("Certificate attached to Thing successfully.");
// Print additional information about the Thing.
describeThing(thingName);
} else {
Throwable cause = ex != null ? ex.getCause() : null;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else if (cause != null) {
System.err.println("Unexpected error: " + cause.getMessage());
} else {
System.err.println("Failed to attach certificate to Thing. HTTP Status Code: " +
attachResponse.sdkHttpResponse().statusCode());
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [AttachThingPrincipal](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/AttachThingPrincipal)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun attachCertificateToThing(
thingNameVal: String?,
certificateArn: String?,
) {
val principalRequest =
AttachThingPrincipalRequest {
thingName = thingNameVal
principal = certificateArn
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.attachThingPrincipal(principalRequest)
println("Certificate attached to $thingNameVal successfully.")
}
}
```
+ Para obtener más información sobre la API, consulta [AttachThingPrincipal](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def attach_thing_principal(self, thing_name, principal):
"""
Attaches a certificate to an AWS IoT thing.
:param thing_name: The name of the thing.
:param principal: The ARN of the certificate.
"""
try:
self.iot_client.attach_thing_principal(
thingName=thing_name, principal=principal
)
logger.info("Attached principal %s to thing %s.", principal, thing_name)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Cannot attach principal. Resource not found.")
return
logger.error(
"Couldn't attach principal to thing. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [AttachThingPrincipal](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/AttachThingPrincipal)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `CreateKeysAndCertificate` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `CreateKeysAndCertificate`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Creates a device certificate for AWS IoT.
///
/// The certificate details including ARN and certificate PEM, or null if creation failed.
public async Task<(string CertificateArn, string CertificatePem, string CertificateId)?> CreateKeysAndCertificateAsync()
{
try
{
var request = new CreateKeysAndCertificateRequest
{
SetAsActive = true
};
var response = await _amazonIoT.CreateKeysAndCertificateAsync(request);
_logger.LogInformation($"Created certificate with ARN {response.CertificateArn}");
return (response.CertificateArn, response.CertificatePem, response.CertificateId);
}
catch (Amazon.IoT.Model.ThrottlingException ex)
{
_logger.LogWarning($"Request throttled, please try again later: {ex.Message}");
return null;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't create certificate. Here's why: {ex.Message}");
return null;
}
}
```
+ Para obtener más información sobre la API, consulta [CreateKeysAndCertificate](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/CreateKeysAndCertificate)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Create keys and certificate for an Aws IoT device.
//! This routine will save certificates and keys to an output folder, if provided.
/*!
\param outputFolder: Location for storing output in files, ignored when string is empty.
\param certificateARNResult: A string to receive the ARN of the created certificate.
\param certificateID: A string to receive the ID of the created certificate.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::createKeysAndCertificate(const Aws::String &outputFolder,
Aws::String &certificateARNResult,
Aws::String &certificateID,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient client(clientConfiguration);
Aws::IoT::Model::CreateKeysAndCertificateRequest createKeysAndCertificateRequest;
Aws::IoT::Model::CreateKeysAndCertificateOutcome outcome =
client.CreateKeysAndCertificate(createKeysAndCertificateRequest);
if (outcome.IsSuccess()) {
std::cout << "Successfully created a certificate and keys" << std::endl;
certificateARNResult = outcome.GetResult().GetCertificateArn();
certificateID = outcome.GetResult().GetCertificateId();
std::cout << "Certificate ARN: " << certificateARNResult << ", certificate ID: "
<< certificateID << std::endl;
if (!outputFolder.empty()) {
std::cout << "Writing certificate and keys to the folder '" << outputFolder
<< "'." << std::endl;
std::cout << "Be sure these files are stored securely." << std::endl;
Aws::String certificateFilePath = outputFolder + "/certificate.pem.crt";
std::ofstream certificateFile(certificateFilePath);
if (!certificateFile.is_open()) {
std::cerr << "Error opening certificate file, '" << certificateFilePath
<< "'."
<< std::endl;
return false;
}
certificateFile << outcome.GetResult().GetCertificatePem();
certificateFile.close();
const Aws::IoT::Model::KeyPair &keyPair = outcome.GetResult().GetKeyPair();
Aws::String privateKeyFilePath = outputFolder + "/private.pem.key";
std::ofstream privateKeyFile(privateKeyFilePath);
if (!privateKeyFile.is_open()) {
std::cerr << "Error opening private key file, '" << privateKeyFilePath
<< "'."
<< std::endl;
return false;
}
privateKeyFile << keyPair.GetPrivateKey();
privateKeyFile.close();
Aws::String publicKeyFilePath = outputFolder + "/public.pem.key";
std::ofstream publicKeyFile(publicKeyFilePath);
if (!publicKeyFile.is_open()) {
std::cerr << "Error opening public key file, '" << publicKeyFilePath
<< "'."
<< std::endl;
return false;
}
publicKeyFile << keyPair.GetPublicKey();
}
}
else {
std::cerr << "Error creating keys and certificate: "
<< outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [CreateKeysAndCertificate](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/CreateKeysAndCertificate)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para crear un par de claves RSA y emitir un certificado X.509**
El siguiente `create-keys-and-certificate` crea un par de claves RSA de 2048 bits y emite un certificado X.509 mediante la clave pública emitida. Como esta es la única vez que el AWS IoT proporciona la clave privada para este certificado, asegúrese de guardarla en un lugar seguro.
```
aws iot create-keys-and-certificate \
--certificate-pem-outfile "myTest.cert.pem" \
--public-key-outfile "myTest.public.key" \
--private-key-outfile "myTest.private.key"
```
Salida:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
"certificateId": "9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
"certificatePem": "
-----BEGIN CERTIFICATE-----
MIICiTCCEXAMPLE6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgEXAMPLEAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSEXAMPLE2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYEXAMPLEb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCEXAMPLEJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAEXAMPLEsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEXAMPLE25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+aEXAMPLE
EXAMPLEfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZEXAMPLELG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAEXAMPLEWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9qEXAMPLEyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----\n",
"keyPair": {
"PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\nMMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\n59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\nhJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\nFQIDAQAB\n-----END PUBLIC KEY-----\n",
"PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nkey omittted for security reasons\n-----END RSA PRIVATE KEY-----\n"
}
}
```
Para obtener más información, consulte [Crear y registrar un certificado de dispositivo de AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-create.html) en la **Guía para desarrolladores de AWS IoT**.
+ Para obtener más información sobre la API, consulte [CreateKeysAndCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-keys-and-certificate.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Creates an IoT certificate asynchronously.
*
* @return The ARN of the created certificate.
*
* This method initiates an asynchronous request to create an IoT certificate.
* If the request is successful, it prints the certificate details and returns the certificate ARN.
* If an exception occurs, it prints the error message.
*/
public String createCertificate() {
CompletableFuture future = getAsyncClient().createKeysAndCertificate();
final String[] certificateArn = {null};
future.whenComplete((response, ex) -> {
if (response != null) {
String certificatePem = response.certificatePem();
certificateArn[0] = response.certificateArn();
// Print the details.
System.out.println("\nCertificate:");
System.out.println(certificatePem);
System.out.println("\nCertificate ARN:");
System.out.println(certificateArn[0]);
} else {
Throwable cause = (ex instanceof CompletionException) ? ex.getCause() : ex;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + cause.getMessage());
}
}
});
future.join();
return certificateArn[0];
}
```
+ Para obtener más información sobre la API, consulta [CreateKeysAndCertificate](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/CreateKeysAndCertificate)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun createCertificate(): String? {
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
val response = iotClient.createKeysAndCertificate()
val certificatePem = response.certificatePem
val certificateArn = response.certificateArn
// Print the details.
println("\nCertificate:")
println(certificatePem)
println("\nCertificate ARN:")
println(certificateArn)
return certificateArn
}
}
```
+ Para obtener más información sobre la API, consulta [CreateKeysAndCertificate](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def create_keys_and_certificate(self):
"""
Creates keys and a certificate for an AWS IoT thing.
:return: The certificate ID, ARN, and PEM.
"""
try:
response = self.iot_client.create_keys_and_certificate(setAsActive=True)
logger.info("Created certificate %s.", response["certificateId"])
except ClientError as err:
if err.response["Error"]["Code"] == "ThrottlingException":
logger.error("Request throttled. Please try again later.")
else:
logger.error(
"Couldn't create keys and certificate. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response
```
+ Para obtener más información sobre la API, consulta [CreateKeysAndCertificate](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/CreateKeysAndCertificate)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `CreateThing` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `CreateThing`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Creates an AWS IoT Thing.
///
/// The name of the Thing to create.
/// The ARN of the Thing created, or null if creation failed.
public async Task CreateThingAsync(string thingName)
{
try
{
var request = new CreateThingRequest
{
ThingName = thingName
};
var response = await _amazonIoT.CreateThingAsync(request);
_logger.LogInformation($"Created Thing {thingName} with ARN {response.ThingArn}");
return response.ThingArn;
}
catch (Amazon.IoT.Model.ResourceAlreadyExistsException ex)
{
_logger.LogWarning($"Thing {thingName} already exists: {ex.Message}");
return null;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't create Thing {thingName}. Here's why: {ex.Message}");
return null;
}
}
```
+ Para obtener más información sobre la API, consulta [CreateThing](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/CreateThing)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Create an AWS IoT thing.
/*!
\param thingName: The name for the thing.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::createThing(const Aws::String &thingName,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::CreateThingRequest createThingRequest;
createThingRequest.SetThingName(thingName);
Aws::IoT::Model::CreateThingOutcome outcome = iotClient.CreateThing(
createThingRequest);
if (outcome.IsSuccess()) {
std::cout << "Successfully created thing " << thingName << std::endl;
}
else {
std::cerr << "Failed to create thing " << thingName << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [CreateThing](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/CreateThing)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Ejemplo 1: creación de un registro de objetos en el registro**
El siguiente `create-thing` ejemplo crea una entrada para un dispositivo en el registro de cosas de AWS IoT.
```
aws iot create-thing \
--thing-name SampleIoTThing
```
Salida:
```
{
"thingName": "SampleIoTThing",
"thingArn": "arn:aws:iot:us-west-2: 123456789012:thing/SampleIoTThing",
"thingId": " EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE "
}
```
**Ejemplo 2: definición de un objeto que está asociado a un tipo de objeto**
En el siguiente ejemplo de `create-thing` se crea un objeto que tiene el tipo de objeto especificado y sus atributos.
```
aws iot create-thing \
--thing-name "MyLightBulb" \
--thing-type-name "LightBulb" \
--attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"
```
Salida:
```
{
"thingName": "MyLightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
"thingId": "40da2e73-c6af-406e-b415-15acae538797"
}
```
Para obtener más información, consulte [How to Manage Things with the Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) y [Thing Types](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte [CreateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Creates an IoT Thing with the specified name asynchronously.
*
* @param thingName The name of the IoT Thing to create.
*
* This method initiates an asynchronous request to create an IoT Thing with the specified name.
* If the request is successful, it prints the name of the thing and its ARN value.
* If an exception occurs, it prints the error message.
*/
public void createIoTThing(String thingName) {
CreateThingRequest createThingRequest = CreateThingRequest.builder()
.thingName(thingName)
.build();
CompletableFuture future = getAsyncClient().createThing(createThingRequest);
future.whenComplete((createThingResponse, ex) -> {
if (createThingResponse != null) {
System.out.println(thingName + " was successfully created. The ARN value is " + createThingResponse.thingArn());
} else {
Throwable cause = ex.getCause();
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + cause.getMessage());
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [CreateThing](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/CreateThing)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun createIoTThing(thingNameVal: String) {
val createThingRequest =
CreateThingRequest {
thingName = thingNameVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.createThing(createThingRequest)
println("Created $thingNameVal}")
}
}
```
+ Para obtener más información sobre la API, consulta [CreateThing](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def create_thing(self, thing_name):
"""
Creates an AWS IoT thing.
:param thing_name: The name of the thing to create.
:return: The name and ARN of the created thing.
"""
try:
response = self.iot_client.create_thing(thingName=thing_name)
logger.info("Created thing %s.", thing_name)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceAlreadyExistsException":
logger.info("Thing %s already exists. Skipping creation.", thing_name)
return None
logger.error(
"Couldn't create thing %s. Here's why: %s: %s",
thing_name,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response
```
+ Para obtener más información sobre la API, consulta [CreateThing](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/CreateThing)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `CreateTopicRule` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `CreateTopicRule`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Creates an IoT topic rule.
///
/// The name of the rule.
/// The ARN of the SNS topic for the action.
/// The ARN of the IAM role.
/// True if successful, false otherwise.
public async Task CreateTopicRuleAsync(string ruleName, string snsTopicArn, string roleArn)
{
try
{
var request = new CreateTopicRuleRequest
{
RuleName = ruleName,
TopicRulePayload = new TopicRulePayload
{
Sql = "SELECT * FROM 'topic/subtopic'",
Description = $"Rule created by .NET example: {ruleName}",
Actions = new List
{
new Amazon.IoT.Model.Action
{
Sns = new SnsAction
{
TargetArn = snsTopicArn,
RoleArn = roleArn
}
}
},
RuleDisabled = false
}
};
await _amazonIoT.CreateTopicRuleAsync(request);
_logger.LogInformation($"Created IoT rule {ruleName}");
return true;
}
catch (Amazon.IoT.Model.ResourceAlreadyExistsException ex)
{
_logger.LogWarning($"Rule {ruleName} already exists: {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't create topic rule. Here's why: {ex.Message}");
return false;
}
}
```
+ Para obtener más información sobre la API, consulta [CreateTopicRule](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/CreateTopicRule)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Create an AWS IoT rule with an SNS topic as the target.
/*!
\param ruleName: The name for the rule.
\param snsTopic: The SNS topic ARN for the action.
\param sql: The SQL statement used to query the topic.
\param roleARN: The IAM role ARN for the action.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool
AwsDoc::IoT::createTopicRule(const Aws::String &ruleName,
const Aws::String &snsTopicARN, const Aws::String &sql,
const Aws::String &roleARN,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::CreateTopicRuleRequest request;
request.SetRuleName(ruleName);
Aws::IoT::Model::SnsAction snsAction;
snsAction.SetTargetArn(snsTopicARN);
snsAction.SetRoleArn(roleARN);
Aws::IoT::Model::Action action;
action.SetSns(snsAction);
Aws::IoT::Model::TopicRulePayload topicRulePayload;
topicRulePayload.SetSql(sql);
topicRulePayload.SetActions({action});
request.SetTopicRulePayload(topicRulePayload);
auto outcome = iotClient.CreateTopicRule(request);
if (outcome.IsSuccess()) {
std::cout << "Successfully created topic rule " << ruleName << "." << std::endl;
}
else {
std::cerr << "Error creating topic rule " << ruleName << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [CreateTopicRule](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/CreateTopicRule)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para crear una regla que envíe una alerta de Amazon SNS**
En el siguiente ejemplo de `create-topic-rule` se crea una regla que envía un mensaje de Amazon SNS cuando las lecturas del nivel de humedad del suelo son bajas, tal como se encuentran en la sombra de dispositivo.
```
aws iot create-topic-rule \
--rule-name "LowMoistureRule" \
--topic-rule-payload file://plant-rule.json
```
El ejemplo requiere que se guarde el siguiente código JSON en un archivo denominado`plant-rule.json`:
```
{
"sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n",
"description": "Sends an alert whenever soil moisture level readings are too low.",
"ruleDisabled": false,
"awsIotSqlVersion": "2016-03-23",
"actions": [{
"sns": {
"targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic",
"roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole",
"messageFormat": "RAW"
}
}]
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Creación de una regla de AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte [CreateTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Creates an IoT rule asynchronously.
*
* @param roleARN The ARN of the IAM role that grants access to the rule's actions.
* @param ruleName The name of the IoT rule.
* @param action The ARN of the action to perform when the rule is triggered.
*
* This method initiates an asynchronous request to create an IoT rule.
* If the request is successful, it prints a confirmation message.
* If an exception occurs, it prints the error message.
*/
public void createIoTRule(String roleARN, String ruleName, String action) {
String sql = "SELECT * FROM '" + TOPIC + "'";
SnsAction action1 = SnsAction.builder()
.targetArn(action)
.roleArn(roleARN)
.build();
// Create the action.
Action myAction = Action.builder()
.sns(action1)
.build();
// Create the topic rule payload.
TopicRulePayload topicRulePayload = TopicRulePayload.builder()
.sql(sql)
.actions(myAction)
.build();
// Create the topic rule request.
CreateTopicRuleRequest topicRuleRequest = CreateTopicRuleRequest.builder()
.ruleName(ruleName)
.topicRulePayload(topicRulePayload)
.build();
CompletableFuture future = getAsyncClient().createTopicRule(topicRuleRequest);
future.whenComplete((response, ex) -> {
if (response != null) {
System.out.println("IoT Rule created successfully.");
} else {
Throwable cause = ex != null ? ex.getCause() : null;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else if (cause != null) {
System.err.println("Unexpected error: " + cause.getMessage());
} else {
System.err.println("Failed to create IoT Rule.");
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [CreateTopicRule](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/CreateTopicRule)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun createIoTRule(
roleARNVal: String?,
ruleNameVal: String?,
action: String?,
) {
val sqlVal = "SELECT * FROM '$TOPIC '"
val action1 =
SnsAction {
targetArn = action
roleArn = roleARNVal
}
val myAction =
Action {
sns = action1
}
val topicRulePayloadVal =
TopicRulePayload {
sql = sqlVal
actions = listOf(myAction)
}
val topicRuleRequest =
CreateTopicRuleRequest {
ruleName = ruleNameVal
topicRulePayload = topicRulePayloadVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.createTopicRule(topicRuleRequest)
println("IoT rule created successfully.")
}
}
```
+ Para obtener más información sobre la API, consulta [CreateTopicRule](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def create_topic_rule(self, rule_name, topic, sns_action_arn, role_arn):
"""
Creates an AWS IoT topic rule.
:param rule_name: The name of the rule.
:param topic: The MQTT topic to subscribe to.
:param sns_action_arn: The ARN of the SNS topic to publish to.
:param role_arn: The ARN of the IAM role.
"""
try:
self.iot_client.create_topic_rule(
ruleName=rule_name,
topicRulePayload={
"sql": f"SELECT * FROM '{topic}'",
"actions": [
{"sns": {"targetArn": sns_action_arn, "roleArn": role_arn}}
],
},
)
logger.info("Created topic rule %s.", rule_name)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceAlreadyExistsException":
logger.info("Topic rule %s already exists. Skipping creation.", rule_name)
return
logger.error(
"Couldn't create topic rule. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [CreateTopicRule](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/CreateTopicRule)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `DeleteCertificate` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DeleteCertificate`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Deletes an IoT certificate.
///
/// The ID of the certificate to delete.
/// True if successful, false otherwise.
public async Task DeleteCertificateAsync(string certificateId)
{
try
{
// First, update the certificate to inactive state
var updateRequest = new UpdateCertificateRequest
{
CertificateId = certificateId,
NewStatus = CertificateStatus.INACTIVE
};
await _amazonIoT.UpdateCertificateAsync(updateRequest);
// Then delete the certificate
var deleteRequest = new DeleteCertificateRequest
{
CertificateId = certificateId
};
await _amazonIoT.DeleteCertificateAsync(deleteRequest);
_logger.LogInformation($"Deleted certificate {certificateId}");
return true;
}
catch (Amazon.IoT.Model.ResourceNotFoundException ex)
{
_logger.LogError($"Cannot delete certificate - resource not found: {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't delete certificate. Here's why: {ex.Message}");
return false;
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteCertificate](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/DeleteCertificate)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Delete a certificate.
/*!
\param certificateID: The ID of a certificate.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::deleteCertificate(const Aws::String &certificateID,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DeleteCertificateRequest request;
request.SetCertificateId(certificateID);
Aws::IoT::Model::DeleteCertificateOutcome outcome = iotClient.DeleteCertificate(
request);
if (outcome.IsSuccess()) {
std::cout << "Successfully deleted certificate " << certificateID << std::endl;
}
else {
std::cerr << "Error deleting certificate " << certificateID << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DeleteCertificate](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DeleteCertificate)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para eliminar un certificado de dispositivo**
En el siguiente ejemplo de `delete-certificate` se elimina el certificado de dispositivo con el ID especificado.
```
aws iot delete-certificate \
--certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [DeleteCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCertificate.html)la *Referencia de la API de AWS IoT*.
+ Para obtener más información sobre la API, consulte [DeleteCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-certificate.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Deletes a certificate asynchronously.
*
* @param certificateArn The ARN of the certificate to delete.
*
* This method initiates an asynchronous request to delete a certificate.
* If the deletion is successful, it prints a confirmation message.
* If an exception occurs, it prints the error message.
*/
public void deleteCertificate(String certificateArn) {
DeleteCertificateRequest certificateProviderRequest = DeleteCertificateRequest.builder()
.certificateId(extractCertificateId(certificateArn))
.build();
CompletableFuture future = getAsyncClient().deleteCertificate(certificateProviderRequest);
future.whenComplete((voidResult, ex) -> {
if (ex == null) {
System.out.println(certificateArn + " was successfully deleted.");
} else {
Throwable cause = ex.getCause();
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + ex.getMessage());
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [DeleteCertificate](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/DeleteCertificate)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun deleteCertificate(certificateArn: String) {
val certificateProviderRequest =
DeleteCertificateRequest {
certificateId = extractCertificateId(certificateArn)
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.deleteCertificate(certificateProviderRequest)
println("$certificateArn was successfully deleted.")
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteCertificate](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def delete_certificate(self, certificate_id):
"""
Deletes an AWS IoT certificate.
:param certificate_id: The ID of the certificate to delete.
"""
try:
self.iot_client.update_certificate(
certificateId=certificate_id, newStatus="INACTIVE"
)
self.iot_client.delete_certificate(certificateId=certificate_id)
logger.info("Deleted certificate %s.", certificate_id)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Cannot delete certificate. Resource not found.")
return
logger.error(
"Couldn't delete certificate. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [DeleteCertificate](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/DeleteCertificate)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `DeleteThing` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DeleteThing`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Deletes an IoT Thing.
///
/// The name of the Thing to delete.
/// True if successful, false otherwise.
public async Task DeleteThingAsync(string thingName)
{
try
{
var request = new DeleteThingRequest
{
ThingName = thingName
};
await _amazonIoT.DeleteThingAsync(request);
_logger.LogInformation($"Deleted Thing {thingName}");
return true;
}
catch (Amazon.IoT.Model.ResourceNotFoundException ex)
{
_logger.LogError($"Cannot delete Thing - resource not found: {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't delete Thing. Here's why: {ex.Message}");
return false;
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteThing](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/DeleteThing)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Delete an AWS IoT thing.
/*!
\param thingName: The name for the thing.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::deleteThing(const Aws::String &thingName,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DeleteThingRequest request;
request.SetThingName(thingName);
const auto outcome = iotClient.DeleteThing(request);
if (outcome.IsSuccess()) {
std::cout << "Successfully deleted thing " << thingName << std::endl;
}
else {
std::cerr << "Error deleting thing " << thingName << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DeleteThing](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DeleteThing)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para visualizar información detallada acerca de un objeto**
En el siguiente `delete-thing` ejemplo, se elimina un elemento del registro de AWS IoT de tu AWS cuenta.
¿Fue para borrar algo --thing-name» FourthBulb
Este comando no genera ninguna salida.
Para obtener más información, consulte [Administración de objetos con el registro](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) en la *Guía para desarrolladores de AWS IoT*.
+ *Para obtener más información sobre la API, consulte la Referencia de comandos. [DeleteThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing.html)AWS CLI *
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Deletes an IoT Thing asynchronously.
*
* @param thingName The name of the IoT Thing to delete.
*
* This method initiates an asynchronous request to delete an IoT Thing.
* If the deletion is successful, it prints a confirmation message.
* If an exception occurs, it prints the error message.
*/
public void deleteIoTThing(String thingName) {
DeleteThingRequest deleteThingRequest = DeleteThingRequest.builder()
.thingName(thingName)
.build();
CompletableFuture future = getAsyncClient().deleteThing(deleteThingRequest);
future.whenComplete((voidResult, ex) -> {
if (ex == null) {
System.out.println("Deleted Thing " + thingName);
} else {
Throwable cause = ex.getCause();
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + ex.getMessage());
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [DeleteThing](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/DeleteThing)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun deleteIoTThing(thingNameVal: String) {
val deleteThingRequest =
DeleteThingRequest {
thingName = thingNameVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.deleteThing(deleteThingRequest)
println("Deleted $thingNameVal")
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteThing](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def delete_thing(self, thing_name):
"""
Deletes an AWS IoT thing.
:param thing_name: The name of the thing to delete.
"""
try:
self.iot_client.delete_thing(thingName=thing_name)
logger.info("Deleted thing %s.", thing_name)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Cannot delete thing. Resource not found.")
return
logger.error(
"Couldn't delete thing. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [DeleteThing](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/DeleteThing)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `DeleteTopicRule` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DeleteTopicRule`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en su contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Delete an AWS IoT rule.
/*!
\param ruleName: The name for the rule.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::deleteTopicRule(const Aws::String &ruleName,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DeleteTopicRuleRequest request;
request.SetRuleName(ruleName);
Aws::IoT::Model::DeleteTopicRuleOutcome outcome = iotClient.DeleteTopicRule(
request);
if (outcome.IsSuccess()) {
std::cout << "Successfully deleted rule " << ruleName << std::endl;
}
else {
std::cerr << "Failed to delete rule " << ruleName <<
": " << outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DeleteTopicRule](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DeleteTopicRule)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para eliminar una regla**
En el siguiente ejemplo de `delete-topic-rule` se elimina la regla especificada.
```
aws iot delete-topic-rule \
--rule-name "LowMoistureRule"
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Deleting a Rule](https://docs.aws.amazon.com/iot/latest/developerguide/iot-delete-rule.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulta [DeleteTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def delete_topic_rule(self, rule_name):
"""
Deletes an AWS IoT topic rule.
:param rule_name: The name of the rule to delete.
"""
try:
self.iot_client.delete_topic_rule(ruleName=rule_name)
logger.info("Deleted topic rule %s.", rule_name)
except ClientError as err:
logger.error(
"Couldn't delete topic rule. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [DeleteTopicRule](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/DeleteTopicRule)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `DescribeEndpoint` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DescribeEndpoint`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Gets the AWS IoT endpoint URL.
///
/// The endpoint URL, or null if retrieval failed.
public async Task DescribeEndpointAsync()
{
try
{
var request = new DescribeEndpointRequest
{
EndpointType = "iot:Data-ATS"
};
var response = await _amazonIoT.DescribeEndpointAsync(request);
_logger.LogInformation($"Retrieved endpoint: {response.EndpointAddress}");
return response.EndpointAddress;
}
catch (Amazon.IoT.Model.ThrottlingException ex)
{
_logger.LogWarning($"Request throttled, please try again later: {ex.Message}");
return null;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't describe endpoint. Here's why: {ex.Message}");
return null;
}
}
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/DescribeEndpoint)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Describe the endpoint specific to the AWS account making the call.
/*!
\param endpointResult: String to receive the endpoint result.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::describeEndpoint(Aws::String &endpointResult,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::String endpoint;
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DescribeEndpointRequest describeEndpointRequest;
describeEndpointRequest.SetEndpointType(
"iot:Data-ATS"); // Recommended endpoint type.
Aws::IoT::Model::DescribeEndpointOutcome outcome = iotClient.DescribeEndpoint(
describeEndpointRequest);
if (outcome.IsSuccess()) {
std::cout << "Successfully described endpoint." << std::endl;
endpointResult = outcome.GetResult().GetEndpointAddress();
}
else {
std::cerr << "Error describing endpoint" << outcome.GetError().GetMessage()
<< std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DescribeEndpoint)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Ejemplo 1: Para obtener su AWS punto final actual**
El siguiente `describe-endpoint` ejemplo recupera el AWS punto final predeterminado al que se aplican todos los comandos.
```
aws iot describe-endpoint
```
Salida:
```
{
"endpointAddress": "abc123defghijk.iot.us-west-2.amazonaws.com"
}
```
Para obtener más información, consulte [DescribeEndpoint](https://docs.aws.amazon.com/iot/latest/developerguide/iot-commands.html#api-iot-DescribeEndpoint)la *Guía para desarrolladores de AWS IoT*.
**Ejemplo 2: Obtención del punto de conexión ATS**
En el siguiente ejemplo de `describe-endpoint` se recupera el punto de conexión de Amazon Trust Services (ATS).
```
aws iot describe-endpoint \
--endpoint-type iot:Data-ATS
```
Salida:
```
{
"endpointAddress": "abc123defghijk-ats.iot.us-west-2.amazonaws.com"
}
```
Para obtener más información, consulte [Certificados X.509 e AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/managing-device-certs.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte [DescribeEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Describes the endpoint of the IoT service asynchronously.
*
* @return A CompletableFuture containing the full endpoint URL.
*
* This method initiates an asynchronous request to describe the endpoint of the IoT service.
* If the request is successful, it prints and returns the full endpoint URL.
* If an exception occurs, it prints the error message.
*/
public String describeEndpoint() {
CompletableFuture future = getAsyncClient().describeEndpoint(DescribeEndpointRequest.builder().endpointType("iot:Data-ATS").build());
final String[] result = {null};
future.whenComplete((endpointResponse, ex) -> {
if (endpointResponse != null) {
String endpointUrl = endpointResponse.endpointAddress();
String exString = getValue(endpointUrl);
String fullEndpoint = "https://" + exString + "-ats.iot.us-east-1.amazonaws.com";
System.out.println("Full Endpoint URL: " + fullEndpoint);
result[0] = fullEndpoint;
} else {
Throwable cause = (ex instanceof CompletionException) ? ex.getCause() : ex;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + cause.getMessage());
}
}
});
future.join();
return result[0];
}
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/DescribeEndpoint)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun describeEndpoint(): String? {
val request = DescribeEndpointRequest {}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
val endpointResponse = iotClient.describeEndpoint(request)
val endpointUrl: String? = endpointResponse.endpointAddress
val exString: String = getValue(endpointUrl)
val fullEndpoint = "https://$exString-ats.iot.us-east-1.amazonaws.com"
println("Full endpoint URL: $fullEndpoint")
return fullEndpoint
}
}
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def describe_endpoint(self, endpoint_type="iot:Data-ATS"):
"""
Gets the AWS IoT endpoint.
:param endpoint_type: The endpoint type.
:return: The endpoint.
"""
try:
response = self.iot_client.describe_endpoint(endpointType=endpoint_type)
logger.info("Retrieved endpoint %s.", response["endpointAddress"])
except ClientError as err:
if err.response["Error"]["Code"] == "ThrottlingException":
logger.error("Request throttled. Please try again later.")
else:
logger.error(
"Couldn't describe endpoint. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response["endpointAddress"]
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/DescribeEndpoint)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/iot#code-examples).
```
async fn show_address(client: &Client, endpoint_type: &str) -> Result<(), Error> {
let resp = client
.describe_endpoint()
.endpoint_type(endpoint_type)
.send()
.await?;
println!("Endpoint address: {}", resp.endpoint_address.unwrap());
println!();
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [DescribeEndpoint](https://docs.rs/aws-sdk-iot/latest/aws_sdk_iot/client/struct.Client.html#method.describe_endpoint)la *referencia sobre la API de AWS SDK para Rust*.
------
# Úselo `DescribeThing` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DescribeThing`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en su contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Describe an AWS IoT thing.
/*!
\param thingName: The name for the thing.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::describeThing(const Aws::String &thingName,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DescribeThingRequest request;
request.SetThingName(thingName);
Aws::IoT::Model::DescribeThingOutcome outcome = iotClient.DescribeThing(request);
if (outcome.IsSuccess()) {
const Aws::IoT::Model::DescribeThingResult &result = outcome.GetResult();
std::cout << "Retrieved thing '" << result.GetThingName() << "'" << std::endl;
std::cout << "thingArn: " << result.GetThingArn() << std::endl;
std::cout << result.GetAttributes().size() << " attribute(s) retrieved"
<< std::endl;
for (const auto &attribute: result.GetAttributes()) {
std::cout << " attribute: " << attribute.first << "=" << attribute.second
<< std::endl;
}
}
else {
std::cerr << "Error describing thing " << thingName << ": " <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DescribeThing](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DescribeThing)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para visualizar información detallada acerca de un objeto**
El siguiente `describe-thing` ejemplo muestra información sobre una cosa (dispositivo) que está definida en el registro de AWS IoT de su AWS cuenta.
¿Cómo describir-thing --thing-name» MyLightBulb
Salida:
```
{
"defaultClientId": "MyLightBulb",
"thingName": "MyLightBulb",
"thingId": "40da2e73-c6af-406e-b415-15acae538797",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1
}
```
Para obtener más información, consulte [Administración de objetos con el registro](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) en la *Guía para desarrolladores de AWS IoT*.
+ *Para obtener más información sobre la API, consulte la Referencia de comandos. [DescribeThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing.html)AWS CLI *
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Describes an IoT Thing asynchronously.
*
* @param thingName The name of the IoT Thing.
*
* This method initiates an asynchronous request to describe an IoT Thing.
* If the request is successful, it prints the Thing details.
* If an exception occurs, it prints the error message.
*/
private void describeThing(String thingName) {
DescribeThingRequest thingRequest = DescribeThingRequest.builder()
.thingName(thingName)
.build();
CompletableFuture future = getAsyncClient().describeThing(thingRequest);
future.whenComplete((describeResponse, ex) -> {
if (describeResponse != null) {
System.out.println("Thing Details:");
System.out.println("Thing Name: " + describeResponse.thingName());
System.out.println("Thing ARN: " + describeResponse.thingArn());
} else {
Throwable cause = ex != null ? ex.getCause() : null;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else if (cause != null) {
System.err.println("Unexpected error: " + cause.getMessage());
} else {
System.err.println("Failed to describe Thing.");
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [DescribeThing](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/DescribeThing)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun describeThing(thingNameVal: String) {
val thingRequest =
DescribeThingRequest {
thingName = thingNameVal
}
// Print Thing details.
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
val describeResponse = iotClient.describeThing(thingRequest)
println("Thing details:")
println("Thing name: ${describeResponse.thingName}")
println("Thing ARN: ${describeResponse.thingArn}")
}
}
```
+ Para obtener más información sobre la API, consulta [DescribeThing](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
# Úselo `DetachThingPrincipal` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DetachThingPrincipal`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Detaches a certificate from an IoT Thing.
///
/// The name of the Thing.
/// The ARN of the certificate to detach.
/// True if successful, false otherwise.
public async Task DetachThingPrincipalAsync(string thingName, string certificateArn)
{
try
{
var request = new DetachThingPrincipalRequest
{
ThingName = thingName,
Principal = certificateArn
};
await _amazonIoT.DetachThingPrincipalAsync(request);
_logger.LogInformation($"Detached certificate {certificateArn} from Thing {thingName}");
return true;
}
catch (Amazon.IoT.Model.ResourceNotFoundException ex)
{
_logger.LogError($"Cannot detach certificate - resource not found: {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't detach certificate from Thing. Here's why: {ex.Message}");
return false;
}
}
```
+ Para obtener más información sobre la API, consulta [DetachThingPrincipal](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/DetachThingPrincipal)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Detach a principal from an AWS IoT thing.
/*!
\param principal: A principal to detach.
\param thingName: The name for the thing.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::detachThingPrincipal(const Aws::String &principal,
const Aws::String &thingName,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::DetachThingPrincipalRequest detachThingPrincipalRequest;
detachThingPrincipalRequest.SetThingName(thingName);
detachThingPrincipalRequest.SetPrincipal(principal);
Aws::IoT::Model::DetachThingPrincipalOutcome outcome = iotClient.DetachThingPrincipal(
detachThingPrincipalRequest);
if (outcome.IsSuccess()) {
std::cout << "Successfully detached principal " << principal << " from thing "
<< thingName << std::endl;
}
else {
std::cerr << "Failed to detach principal " << principal << " from thing "
<< thingName << ": "
<< outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [DetachThingPrincipal](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/DetachThingPrincipal)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para separar una cosa certificate/principal de una cosa**
En el siguiente ejemplo de `detach-thing-principal` se elimina un certificado que representa una entidad principal del objeto especificado.
```
aws iot detach-thing-principal \
--thing-name "MyLightBulb" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36"
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Administración de objetos con el registro](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener detalles sobre la API, consulte [DetachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-thing-principal.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Detaches a principal (certificate) from an IoT Thing asynchronously.
*
* @param thingName The name of the IoT Thing.
* @param certificateArn The ARN of the certificate to detach.
*
* This method initiates an asynchronous request to detach a certificate from an IoT Thing.
* If the detachment is successful, it prints a confirmation message.
* If an exception occurs, it prints the error message.
*/
public void detachThingPrincipal(String thingName, String certificateArn) {
DetachThingPrincipalRequest thingPrincipalRequest = DetachThingPrincipalRequest.builder()
.principal(certificateArn)
.thingName(thingName)
.build();
CompletableFuture future = getAsyncClient().detachThingPrincipal(thingPrincipalRequest);
future.whenComplete((voidResult, ex) -> {
if (ex == null) {
System.out.println(certificateArn + " was successfully removed from " + thingName);
} else {
Throwable cause = ex.getCause();
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else {
System.err.println("Unexpected error: " + ex.getMessage());
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [DetachThingPrincipal](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/DetachThingPrincipal)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun detachThingPrincipal(
thingNameVal: String,
certificateArn: String,
) {
val thingPrincipalRequest =
DetachThingPrincipalRequest {
principal = certificateArn
thingName = thingNameVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
iotClient.detachThingPrincipal(thingPrincipalRequest)
println("$certificateArn was successfully removed from $thingNameVal")
}
}
```
+ Para obtener más información sobre la API, consulta [DetachThingPrincipal](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def detach_thing_principal(self, thing_name, principal):
"""
Detaches a certificate from an AWS IoT thing.
:param thing_name: The name of the thing.
:param principal: The ARN of the certificate.
"""
try:
self.iot_client.detach_thing_principal(
thingName=thing_name, principal=principal
)
logger.info("Detached principal %s from thing %s.", principal, thing_name)
except ClientError as err:
if err.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Cannot detach principal. Resource not found.")
return
logger.error(
"Couldn't detach principal from thing. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [DetachThingPrincipal](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/DetachThingPrincipal)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `ListCertificates` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `ListCertificates`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Lists all certificates associated with the account.
///
/// List of certificate information, or empty list if listing failed.
public async Task> ListCertificatesAsync()
{
try
{
var request = new ListCertificatesRequest();
var response = await _amazonIoT.ListCertificatesAsync(request);
_logger.LogInformation($"Retrieved {response.Certificates.Count} certificates");
return response.Certificates;
}
catch (Amazon.IoT.Model.ThrottlingException ex)
{
_logger.LogWarning($"Request throttled, please try again later: {ex.Message}");
return new List();
}
catch (Exception ex)
{
_logger.LogError($"Couldn't list certificates. Here's why: {ex.Message}");
return new List();
}
}
```
+ Para obtener más información sobre la API, consulta [ListCertificates](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/ListCertificates)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! List certificates registered in the AWS account making the call.
/*!
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::listCertificates(
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::ListCertificatesRequest request;
Aws::Vector allCertificates;
Aws::String marker; // Used to paginate results.
do {
if (!marker.empty()) {
request.SetMarker(marker);
}
Aws::IoT::Model::ListCertificatesOutcome outcome = iotClient.ListCertificates(
request);
if (outcome.IsSuccess()) {
const Aws::IoT::Model::ListCertificatesResult &result = outcome.GetResult();
marker = result.GetNextMarker();
allCertificates.insert(allCertificates.end(),
result.GetCertificates().begin(),
result.GetCertificates().end());
}
else {
std::cerr << "Error: " << outcome.GetError().GetMessage() << std::endl;
return false;
}
} while (!marker.empty());
std::cout << allCertificates.size() << " certificate(s) found." << std::endl;
for (auto &certificate: allCertificates) {
std::cout << "Certificate ID: " << certificate.GetCertificateId() << std::endl;
std::cout << "Certificate ARN: " << certificate.GetCertificateArn()
<< std::endl;
std::cout << std::endl;
}
return true;
}
```
+ Para obtener más información sobre la API, consulta [ListCertificates](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/ListCertificates)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Ejemplo 1: Para enumerar los certificados registrados en su AWS cuenta**
En el siguiente ejemplo de `list-certificates` se muestra una lista de todos los certificados registrados en la cuenta. Si supera el límite de paginación predeterminado de 25, puede utilizar el valor de respuesta `nextMarker` de este comando e introducirlo en el siguiente comando para obtener el siguiente lote de resultados. Repita el procedimiento hasta que `nextMarker` no devuelva ningún valor.
```
aws iot list-certificates
```
Salida:
```
{
"certificates": [
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
"certificateId": "604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
"status": "ACTIVE",
"creationDate": 1556810537.617
},
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
"certificateId": "262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
"status": "ACTIVE",
"creationDate": 1546447050.885
},
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
"certificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
"status": "ACTIVE",
"creationDate": 1546292258.322
},
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
"certificateId": "7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
"status": "ACTIVE",
"creationDate": 1541457693.453
},
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
"certificateId": "54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
"status": "ACTIVE",
"creationDate": 1541113568.611
},
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
"certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
"status": "ACTIVE",
"creationDate": 1541022751.983
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Lists all certificates asynchronously.
*
* This method initiates an asynchronous request to list all certificates.
* If the request is successful, it prints the certificate IDs and ARNs.
* If an exception occurs, it prints the error message.
*/
public void listCertificates() {
CompletableFuture future = getAsyncClient().listCertificates();
future.whenComplete((response, ex) -> {
if (response != null) {
List certList = response.certificates();
for (Certificate cert : certList) {
System.out.println("Cert id: " + cert.certificateId());
System.out.println("Cert Arn: " + cert.certificateArn());
}
} else {
Throwable cause = ex != null ? ex.getCause() : null;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else if (cause != null) {
System.err.println("Unexpected error: " + cause.getMessage());
} else {
System.err.println("Failed to list certificates.");
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [ListCertificates](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/ListCertificates)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun listCertificates() {
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
val response = iotClient.listCertificates()
val certList = response.certificates
certList?.forEach { cert ->
println("Cert id: ${cert.certificateId}")
println("Cert Arn: ${cert.certificateArn}")
}
}
}
```
+ Para obtener más información sobre la API, consulta [ListCertificates](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def list_certificates(self):
"""
Lists AWS IoT certificates.
:return: The list of certificates.
"""
try:
certificates = []
paginator = self.iot_client.get_paginator("list_certificates")
for page in paginator.paginate():
certificates.extend(page["certificates"])
logger.info("Retrieved %s certificates.", len(certificates))
return certificates
except ClientError as err:
if err.response["Error"]["Code"] == "ThrottlingException":
logger.error("Request throttled. Please try again later.")
else:
logger.error(
"Couldn't list certificates. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [ListCertificates](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/ListCertificates)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `ListThings` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `ListThings`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Lists IoT Things with pagination support.
///
/// List of Things, or empty list if listing failed.
public async Task> ListThingsAsync()
{
try
{
// Use pages of 10.
var request = new ListThingsRequest()
{
MaxResults = 10
};
var response = await _amazonIoT.ListThingsAsync(request);
// Since there is not a built-in paginator, use the NextMarker to paginate.
bool hasMoreResults = true;
var things = new List();
while (hasMoreResults)
{
things.AddRange(response.Things);
// If NextMarker is not null, there are more results. Get the next page of results.
if (!String.IsNullOrEmpty(response.NextMarker))
{
request.Marker = response.NextMarker;
response = await _amazonIoT.ListThingsAsync(request);
}
else
hasMoreResults = false;
}
_logger.LogInformation($"Retrieved {things.Count} Things");
return things;
}
catch (Amazon.IoT.Model.ThrottlingException ex)
{
_logger.LogWarning($"Request throttled, please try again later: {ex.Message}");
return new List();
}
catch (Exception ex)
{
_logger.LogError($"Couldn't list Things. Here's why: {ex.Message}");
return new List();
}
}
```
+ Para obtener más información sobre la API, consulta [ListThings](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/ListThings)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Ejemplo 1: Creación de una lista de todos los objetos del registro**
En el siguiente `list-things` ejemplo, se enumeran las cosas (dispositivos) que están definidas en el registro de AWS IoT de su AWS cuenta.
```
aws iot list-things
```
Salida:
```
{
"things": [
{
"thingName": "ThirdBulb",
"thingTypeName": "LightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/ThirdBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 2
},
{
"thingName": "MyOtherLightBulb",
"thingTypeName": "LightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 3
},
{
"thingName": "MyLightBulb",
"thingTypeName": "LightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1
},
{
"thingName": "SampleIoTThing",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/SampleIoTThing",
"attributes": {},
"version": 1
}
]
}
```
**Ejemplo 2: Creación de una lista de los objetos definidos que tienen un atributo específico**
En el siguiente ejemplo de `list-things` se muestra una lista de objetos que tienen un atributo denominado `wattage`.
```
aws iot list-things \
--attribute-name wattage
```
Salida:
```
{
"things": [
{
"thingName": "MyLightBulb",
"thingTypeName": "LightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1
},
{
"thingName": "MyOtherLightBulb",
"thingTypeName": "LightBulb",
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 3
}
]
}
```
Para obtener más información, consulte [Administración de objetos con el registro](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte [ListThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def list_things(self):
"""
Lists AWS IoT things.
:return: The list of things.
"""
try:
things = []
paginator = self.iot_client.get_paginator("list_things")
for page in paginator.paginate():
things.extend(page["things"])
logger.info("Retrieved %s things.", len(things))
return things
except ClientError as err:
if err.response["Error"]["Code"] == "ThrottlingException":
logger.error("Request throttled. Please try again later.")
else:
logger.error(
"Couldn't list things. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [ListThings](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/ListThings)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/iot#code-examples).
```
async fn show_things(client: &Client) -> Result<(), Error> {
let resp = client.list_things().send().await?;
println!("Things:");
for thing in resp.things.unwrap() {
println!(
" Name: {}",
thing.thing_name.as_deref().unwrap_or_default()
);
println!(
" Type: {}",
thing.thing_type_name.as_deref().unwrap_or_default()
);
println!(
" ARN: {}",
thing.thing_arn.as_deref().unwrap_or_default()
);
println!();
}
println!();
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [ListThings](https://docs.rs/aws-sdk-iot/latest/aws_sdk_iot/client/struct.Client.html#method.list_things)la *referencia sobre la API de AWS SDK para Rust*.
------
# Úselo `SearchIndex` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `SearchIndex`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Searches for IoT Things using the search index.
///
/// The search query string.
/// List of Things that match the search criteria, or empty list if search failed.
public async Task> SearchIndexAsync(string queryString)
{
try
{
// First, try to perform the search
var request = new SearchIndexRequest
{
QueryString = queryString
};
var response = await _amazonIoT.SearchIndexAsync(request);
_logger.LogInformation($"Search found {response.Things.Count} Things");
return response.Things;
}
catch (Amazon.IoT.Model.IndexNotReadyException ex)
{
_logger.LogWarning($"Search index not ready, setting up indexing configuration: {ex.Message}");
return await SetupIndexAndRetrySearchAsync(queryString);
}
catch (Amazon.IoT.Model.ResourceNotFoundException ex) when (ex.Message.Contains("index") || ex.Message.Contains("Index"))
{
_logger.LogWarning($"Search index not configured, setting up indexing configuration: {ex.Message}");
return await SetupIndexAndRetrySearchAsync(queryString);
}
catch (Amazon.IoT.Model.ThrottlingException ex)
{
_logger.LogWarning($"Request throttled, please try again later: {ex.Message}");
return new List();
}
catch (Exception ex)
{
_logger.LogError($"Couldn't search index. Here's why: {ex.Message}");
return new List();
}
}
///
/// Sets up the indexing configuration and retries the search after waiting for the index to be ready.
///
/// The search query string.
/// List of Things that match the search criteria, or empty list if setup/search failed.
private async Task> SetupIndexAndRetrySearchAsync(string queryString)
{
try
{
// Update indexing configuration to REGISTRY mode
_logger.LogInformation("Setting up IoT search indexing configuration...");
await _amazonIoT.UpdateIndexingConfigurationAsync(
new UpdateIndexingConfigurationRequest()
{
ThingIndexingConfiguration = new ThingIndexingConfiguration()
{
ThingIndexingMode = ThingIndexingMode.REGISTRY
}
});
_logger.LogInformation("Indexing configuration updated. Waiting for index to be ready...");
// Wait for the index to be set up - this can take some time
const int maxRetries = 10;
const int retryDelaySeconds = 10;
for (int attempt = 1; attempt <= maxRetries; attempt++)
{
try
{
_logger.LogInformation($"Waiting for index to be ready (attempt {attempt}/{maxRetries})...");
await Task.Delay(TimeSpan.FromSeconds(retryDelaySeconds));
// Try to get the current indexing configuration to see if it's ready
var configResponse = await _amazonIoT.GetIndexingConfigurationAsync(new GetIndexingConfigurationRequest());
if (configResponse.ThingIndexingConfiguration?.ThingIndexingMode == ThingIndexingMode.REGISTRY)
{
// Try the search again
var request = new SearchIndexRequest
{
QueryString = queryString
};
var response = await _amazonIoT.SearchIndexAsync(request);
_logger.LogInformation($"Search found {response.Things.Count} Things after index setup");
return response.Things;
}
}
catch (Amazon.IoT.Model.IndexNotReadyException)
{
// Index still not ready, continue waiting
_logger.LogInformation("Index still not ready, continuing to wait...");
continue;
}
catch (Amazon.IoT.Model.InvalidRequestException ex) when (ex.Message.Contains("index") || ex.Message.Contains("Index"))
{
// Index still not ready, continue waiting
_logger.LogInformation("Index still not ready, continuing to wait...");
continue;
}
}
_logger.LogWarning("Timeout waiting for search index to be ready after configuration update");
return new List();
}
catch (Exception ex)
{
_logger.LogError($"Couldn't set up search index configuration. Here's why: {ex.Message}");
return new List();
}
}
```
+ Para obtener más información sobre la API, consulta [SearchIndex](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/SearchIndex)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Query the AWS IoT fleet index.
//! For query information, see https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html
/*!
\param: query: The query string.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::searchIndex(const Aws::String &query,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::SearchIndexRequest request;
request.SetQueryString(query);
Aws::Vector allThingDocuments;
Aws::String nextToken; // Used for pagination.
do {
if (!nextToken.empty()) {
request.SetNextToken(nextToken);
}
Aws::IoT::Model::SearchIndexOutcome outcome = iotClient.SearchIndex(request);
if (outcome.IsSuccess()) {
const Aws::IoT::Model::SearchIndexResult &result = outcome.GetResult();
allThingDocuments.insert(allThingDocuments.end(),
result.GetThings().cbegin(),
result.GetThings().cend());
nextToken = result.GetNextToken();
}
else {
std::cerr << "Error in SearchIndex: " << outcome.GetError().GetMessage()
<< std::endl;
return false;
}
} while (!nextToken.empty());
std::cout << allThingDocuments.size() << " thing document(s) found." << std::endl;
for (const auto thingDocument: allThingDocuments) {
std::cout << " Thing name: " << thingDocument.GetThingName() << "."
<< std::endl;
}
return true;
}
```
+ Para obtener más información sobre la API, consulta [SearchIndex](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/SearchIndex)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para consultar el índice de objetos**
En el siguiente ejemplo de `search-index` se consulta en el índice de `AWS_Things` los objetos que son del tipo `LightBulb`.
```
aws iot search-index \
--index-name "AWS_Things" \
--query-string "thingTypeName:LightBulb"
```
Salida:
```
{
"things": [
{
"thingName": "MyLightBulb",
"thingId": "40da2e73-c6af-406e-b415-15acae538797",
"thingTypeName": "LightBulb",
"thingGroupNames": [
"LightBulbs",
"DeadBulbs"
],
"attributes": {
"model": "123",
"wattage": "75"
},
"connectivity": {
"connected": false
}
},
{
"thingName": "ThirdBulb",
"thingId": "615c8455-33d5-40e8-95fd-3ee8b24490af",
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"connectivity": {
"connected": false
}
},
{
"thingName": "MyOtherLightBulb",
"thingId": "6dae0d3f-40c1-476a-80c4-1ed24ba6aa11",
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"connectivity": {
"connected": false
}
}
]
}
```
Para obtener más información, consulte [Managing Thing Indexing](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html), en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulta [SearchIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/search-index.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/iot#code-examples).
```
/**
* Searches for IoT Things asynchronously based on a query string.
*
* @param queryString The query string to search for Things.
*
* This method initiates an asynchronous request to search for IoT Things.
* If the request is successful and Things are found, it prints their IDs.
* If no Things are found, it prints a message indicating so.
* If an exception occurs, it prints the error message.
*/
public void searchThings(String queryString) {
SearchIndexRequest searchIndexRequest = SearchIndexRequest.builder()
.queryString(queryString)
.build();
CompletableFuture future = getAsyncClient().searchIndex(searchIndexRequest);
future.whenComplete((searchIndexResponse, ex) -> {
if (searchIndexResponse != null) {
// Process the result.
if (searchIndexResponse.things().isEmpty()) {
System.out.println("No things found.");
} else {
searchIndexResponse.things().forEach(thing -> System.out.println("Thing id found using search is " + thing.thingId()));
}
} else {
Throwable cause = ex != null ? ex.getCause() : null;
if (cause instanceof IotException) {
System.err.println(((IotException) cause).awsErrorDetails().errorMessage());
} else if (cause != null) {
System.err.println("Unexpected error: " + cause.getMessage());
} else {
System.err.println("Failed to search for IoT Things.");
}
}
});
future.join();
}
```
+ Para obtener más información sobre la API, consulta [SearchIndex](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/SearchIndex)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun searchThings(queryStringVal: String?) {
val searchIndexRequest =
SearchIndexRequest {
queryString = queryStringVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
val searchIndexResponse = iotClient.searchIndex(searchIndexRequest)
if (searchIndexResponse.things?.isEmpty() == true) {
println("No things found.")
} else {
searchIndexResponse.things
?.forEach { thing -> println("Thing id found using search is ${thing.thingId}") }
}
}
}
```
+ Para obtener más información sobre la API, consulta [SearchIndex](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def search_index(self, query):
"""
Searches the AWS IoT index.
:param query: The search query.
:return: The list of things found.
"""
try:
response = self.iot_client.search_index(queryString=query)
logger.info("Found %s things.", len(response.get("things", [])))
except ClientError as err:
if err.response["Error"]["Code"] == "ThrottlingException":
logger.error("Request throttled. Please try again later.")
else:
logger.error(
"Couldn't search index. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response.get("things", [])
```
+ Para obtener más información sobre la API, consulta [SearchIndex](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/SearchIndex)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `UpdateIndexingConfiguration` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `UpdateIndexingConfiguration`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en su contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Update the indexing configuration.
/*!
\param thingIndexingConfiguration: A ThingIndexingConfiguration object which is ignored if not set.
\param thingGroupIndexingConfiguration: A ThingGroupIndexingConfiguration object which is ignored if not set.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::updateIndexingConfiguration(
const Aws::IoT::Model::ThingIndexingConfiguration &thingIndexingConfiguration,
const Aws::IoT::Model::ThingGroupIndexingConfiguration &thingGroupIndexingConfiguration,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::UpdateIndexingConfigurationRequest request;
if (thingIndexingConfiguration.ThingIndexingModeHasBeenSet()) {
request.SetThingIndexingConfiguration(thingIndexingConfiguration);
}
if (thingGroupIndexingConfiguration.ThingGroupIndexingModeHasBeenSet()) {
request.SetThingGroupIndexingConfiguration(thingGroupIndexingConfiguration);
}
Aws::IoT::Model::UpdateIndexingConfigurationOutcome outcome = iotClient.UpdateIndexingConfiguration(
request);
if (outcome.IsSuccess()) {
std::cout << "UpdateIndexingConfiguration succeeded." << std::endl;
}
else {
std::cerr << "UpdateIndexingConfiguration failed."
<< outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [UpdateIndexingConfiguration](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/UpdateIndexingConfiguration)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para activar la indexación de objetos**
El siguiente `update-indexing-configuration` ejemplo permite que la indexación de cosas permita buscar datos de registro, datos paralelos y estado de conectividad de cosas mediante el índice AWS\$1Things.
```
aws iot update-indexing-configuration
--thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Managing Thing Indexing](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte la Referencia [UpdateIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-indexing-configuration.html)de *AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/iot#code-examples).
```
class IoTWrapper:
"""Encapsulates AWS IoT actions."""
def __init__(self, iot_client, iot_data_client=None):
"""
:param iot_client: A Boto3 AWS IoT client.
:param iot_data_client: A Boto3 AWS IoT Data Plane client.
"""
self.iot_client = iot_client
self.iot_data_client = iot_data_client
@classmethod
def from_client(cls):
iot_client = boto3.client("iot")
iot_data_client = boto3.client("iot-data")
return cls(iot_client, iot_data_client)
def update_indexing_configuration(self):
"""
Updates the AWS IoT indexing configuration to enable thing indexing.
"""
try:
self.iot_client.update_indexing_configuration(
thingIndexingConfiguration={"thingIndexingMode": "REGISTRY"}
)
logger.info("Updated indexing configuration.")
except ClientError as err:
logger.error(
"Couldn't update indexing configuration. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ Para obtener más información sobre la API, consulta [UpdateIndexingConfiguration](https://docs.aws.amazon.com/goto/boto3/iot-2015-05-28/UpdateIndexingConfiguration)la *AWS Referencia de API de SDK for Python (Boto3*).
------
# Úselo `UpdateThing` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `UpdateThing`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](iot_example_iot_Scenario_section.md)
------
#### [ .NET ]
**SDK para .NET (v4)**
Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/IoT#code-examples).
```
///
/// Updates an IoT Thing with attributes.
///
/// The name of the Thing to update.
/// Dictionary of attributes to add.
/// True if successful, false otherwise.
public async Task UpdateThingAsync(string thingName, Dictionary attributes)
{
try
{
var request = new UpdateThingRequest
{
ThingName = thingName,
AttributePayload = new AttributePayload
{
Attributes = attributes,
Merge = true
}
};
await _amazonIoT.UpdateThingAsync(request);
_logger.LogInformation($"Updated Thing {thingName} with attributes");
return true;
}
catch (Amazon.IoT.Model.ResourceNotFoundException ex)
{
_logger.LogError($"Cannot update Thing - resource not found: {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError($"Couldn't update Thing attributes. Here's why: {ex.Message}");
return false;
}
}
```
+ Para obtener más información sobre la API, consulta [UpdateThing](https://docs.aws.amazon.com/goto/DotNetSDKV4/iot-2015-05-28/UpdateThing)la *Referencia AWS SDK para .NET de la API*.
------
#### [ C\$1\$1 ]
**SDK para C\$1\$1**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/iot#code-examples).
```
//! Update an AWS IoT thing with attributes.
/*!
\param thingName: The name for the thing.
\param attributeMap: A map of key/value attributes/
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::IoT::updateThing(const Aws::String &thingName,
const std::map &attributeMap,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::IoT::IoTClient iotClient(clientConfiguration);
Aws::IoT::Model::UpdateThingRequest request;
request.SetThingName(thingName);
Aws::IoT::Model::AttributePayload attributePayload;
for (const auto &attribute: attributeMap) {
attributePayload.AddAttributes(attribute.first, attribute.second);
}
request.SetAttributePayload(attributePayload);
Aws::IoT::Model::UpdateThingOutcome outcome = iotClient.UpdateThing(request);
if (outcome.IsSuccess()) {
std::cout << "Successfully updated thing " << thingName << std::endl;
}
else {
std::cerr << "Failed to update thing " << thingName << ":" <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Para obtener más información sobre la API, consulta [UpdateThing](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/UpdateThing)la *Referencia AWS SDK para C\$1\$1 de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para asociar un objeto con un tipo de objeto**
El siguiente `update-thing` ejemplo asocia una cosa del registro de AWS IoT a un tipo de cosa. Al realizar la asociación, se proporcionan valores para los atributos definidos por el tipo de objeto.
```
aws iot update-thing \
--thing-name "MyOtherLightBulb" \
--thing-type-name "LightBulb" \
--attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"
```
Este comando no proporciona ningún resultado. Para ver el resultado, use el comando `describe-thing`.
Para obtener más información, consulte [Thing Types](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener más información sobre la API, consulte [UpdateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing.html)la *Referencia de AWS CLI comandos*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/iot#code-examples).
```
suspend fun updateThing(thingNameVal: String?) {
val newLocation = "Office"
val newFirmwareVersion = "v2.0"
val attMap: MutableMap = HashMap()
attMap["location"] = newLocation
attMap["firmwareVersion"] = newFirmwareVersion
val attributePayloadVal =
AttributePayload {
attributes = attMap
}
val updateThingRequest =
UpdateThingRequest {
thingName = thingNameVal
attributePayload = attributePayloadVal
}
IotClient.fromEnvironment { region = "us-east-1" }.use { iotClient ->
// Update the IoT thing attributes.
iotClient.updateThing(updateThingRequest)
println("$thingNameVal attributes updated successfully.")
}
}
```
+ Para obtener más información sobre la API, consulta [UpdateThing](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------