Ações, recursos e chaves de condição do AWS IoT Wireless
O AWS IoT Wireless (prefixo de serviço: iotwireless) fornece os recursos, ações e chaves de contexto de condição a seguir específicos do serviço para uso em políticas de permissão do IAM.
Referências:
-
Saiba como configurar este serviço.
-
Visualize uma lista das operações de API disponíveis para este serviço.
-
Saiba como proteger esse serviço e seus recursos usando políticas de permissão do IAM.
Tópicos
Ações definidas pelo AWS IoT Wireless
Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.
A coluna Nível de acesso da tabela Ações descreve como a ação é classificada (lista, leitura, gravação, gerenciamento de permissões ou marcação). Esta classificação pode ajudar você a compreender o nível de acesso que uma ação concede quando a usa em uma política. Para obter mais informações sobre níveis de acesso, consulte Níveis de acesso em resumos de políticas.
A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.
A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.
A coluna Ações dependentes da tabela Ações mostra permissões adicionais que podem ser necessárias para chamar uma ação com êxito. Essas permissões podem ser necessárias além da permissão para a ação em si. Quando uma ação especifica ações dependentes, essas dependências podem se aplicar a recursos adicionais definidos para essa ação, não somente ao primeiro recurso listado na tabela.
nota
As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.
Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.
| Ações | Descrição | Nível de acesso | Tipos de recursos (*necessários) | Chaves de condição | Ações dependentes |
|---|---|---|---|---|---|
| AssociateAwsAccountWithPartnerAccount | Concede permissão para vincular contas de parceiros à Conta da AWS | Gravar | |||
| AssociateMulticastGroupWithFuotaTask | Concede permissão para associar o MulticastGroup à FuotaTask | Gravar | |||
| AssociateWirelessDeviceWithFuotaTask | Concede permissão para associar o dispositivo sem fio à FuotaTask | Gravar | |||
| AssociateWirelessDeviceWithMulticastGroup | Concede permissão para associar o MulticastGroup à FuotaTask | Gravar | |||
| AssociateWirelessDeviceWithThing | Concede permissão para associar o dispositivo sem fio à coisa do AWS IoT para um determinado wirelessDeviceId | Write |
iot:DescribeThing |
||
| AssociateWirelessGatewayWithCertificate | Concede permissão para associar um WirelessGateway ao certificado de identidade do IoT Core | Write | |||
| AssociateWirelessGatewayWithThing | Concede permissão para associar o gateway sem fio à coisa do AWS IoT para um determinado wirelessGatewayId | Gravar |
iot:DescribeThing |
||
| CancelMulticastGroupSession | Concede permissão para cancelar a sessão MulticastGroup | Gravar | |||
| CreateDestination | Concede permissão para criar um recurso de destino | Write | |||
| CreateDeviceProfile | Concede permissão para criar um recurso DeviceProfile | Gravar | |||
| CreateFuotaTask | Concede permissão para criar um recurso de FuotaTask | Gravar | |||
| CreateMulticastGroup | Concede permissão para criar um recurso MulticastGroup | Gravar | |||
| CreateNetworkAnalyzerConfiguration | Concede permissão para criar um recurso NetworkAnalyzerConfiguration | Gravar | |||
| CreateServiceProfile | Concede permissão para criar um recurso ServiceProfile | Write | |||
| CreateWirelessDevice | Concede permissão para criar um recurso WirelessDevice com determinado destino | Write | |||
| CreateWirelessGateway | Concede permissão para criar um recurso WirelessGateway | Write | |||
| CreateWirelessGatewayTask | Concede permissão para criar uma tarefa para determinado WirelessGateway | Write | |||
| CreateWirelessGatewayTaskDefinition | Concede permissão para criar uma definição de tarefa do WirelessGateway | Write | |||
| DeleteDestination | Concede permissão para excluir um destino | Write | |||
| DeleteDeviceProfile | Concede permissão para excluir um DeviceProfile | Gravar | |||
| DeleteFuotaTask | Concede permissão para excluir o FuotaTask | Gravar | |||
| DeleteMulticastGroup | Concede permissão para excluir o MulticastGroup | Gravar | |||
| DeleteNetworkAnalyzerConfiguration | Concede permissão para excluir o NetworkAnalyzerConfiguration | Gravar | |||
| DeleteQueuedMessages | Concede permissão para excluir mensagens na fila | Gravar | |||
| DeleteServiceProfile | Concede permissão para excluir um ServiceProfile | Write | |||
| DeleteWirelessDevice | Concede permissão para excluir um WirelessDevice | Gravar | |||
| DeleteWirelessDeviceImportTask | Concede permissão para excluir a tarefa de importação de dispositivos sem fio | Gravar | |||
| DeleteWirelessGateway | Concede permissão para excluir um WirelessGateway | Write | |||
| DeleteWirelessGatewayTask | Concede permissão para excluir tarefa de determinado WirelessGateway | Write | |||
| DeleteWirelessGatewayTaskDefinition | Concede permissão para excluir uma definição de tarefa do WirelessGateway | Gravar | |||
| DeregisterWirelessDevice | Concede permissão para cancelar o registro de um dispositivo sem fio | Gravar | |||
| DisassociateAwsAccountFromPartnerAccount | Concede permissão para desassociar uma Conta da AWS de uma conta de parceiro | Gravar | |||
| DisassociateMulticastGroupFromFuotaTask | Concede permissão para desassociar o MulticastGroup da FuotaTask | Gravar | |||
| DisassociateWirelessDeviceFromFuotaTask | Concede permissão para desassociar um dispositivo sem fio de FuotaTask | Gravar | |||
| DisassociateWirelessDeviceFromMulticastGroup | Concede permissão para desassociar um dispositivo sem fio de MulticastGroup | Gravar | |||
| DisassociateWirelessDeviceFromThing | Concede permissão para desassociar um dispositivo sem fio de uma coisa do AWS IoT | Write |
iot:DescribeThing |
||
| DisassociateWirelessGatewayFromCertificate | Concede permissão para desassociar um WirelessGateway de um certificado de identidade do IoT Core | Write | |||
| DisassociateWirelessGatewayFromThing | Concede permissão para desassociar um WirelessGateway de uma coisa do IoT Core | Write |
iot:DescribeThing |
||
| GetDestination | Concede permissão para obter o destino | Read | |||
| GetDeviceProfile | Concede permissão para obter o DeviceProfile | Leitura | |||
| GetEventConfigurationByResourceTypes | Concede permissão para obter a configuração de evento por tipos de recurso | Leitura | |||
| GetFuotaTask | Concede permissão para obter o FuotaTask | Leitura | |||
| GetLogLevelsByResourceTypes | Concede permissão para obter níveis de log por tipos de recurso | Leitura | |||
| GetMetricConfiguration | Concede permissão para obter a configuração de métricas | Leitura | |||
| GetMetrics | Concede permissão para obter métricas | Leitura | |||
| GetMulticastGroup | Concede permissão para obter o MulticastGroup | Leitura | |||
| GetMulticastGroupSession | Concede permissão para obter a sessão MulticastGroup | Leitura | |||
| GetNetworkAnalyzerConfiguration | Concede permissão para obter o NetworkAnalyzerConfiguration | Leitura | |||
| GetPartnerAccount | Concede permissão para obter a PartnerAccount associada | Leitura | |||
| GetPosition | Concede permissão para obter a posição de um determinado recurso | Leitura | |||
| GetPositionConfiguration | Concede permissão para obter a configuração de posição de um determinado recurso | Leitura | |||
| GetPositionEstimate | Concede permissão para obter uma estimativa de posição | Leitura | |||
| GetResourceEventConfiguration | Concede permissão para obter uma configuração de evento para um identificador | Leitura | |||
| GetResourceLogLevel | Concede permissão para obter o nível de log do recurso | Leitura | |||
| GetResourcePosition | Concede permissão para obter a posição de um determinado recurso | Leitura | |||
| GetServiceEndpoint | Concede permissão para recuperar o endpoint específico da conta de cliente para conexão de protocolo CUPS ou conexão de protocolo LoRaWAN Network Server (LNS) e, opcionalmente, o certificado de confiança do servidor no formato PEM | Read | |||
| GetServiceProfile | Concede permissão para obter o ServiceProfile | Read | |||
| GetWirelessDevice | Concede permissão para obter o WirelessDevice | Leitura | |||
| GetWirelessDeviceImportTask | Concede permissão para obter a tarefa de importação de dispositivos sem fio | Leitura | |||
| GetWirelessDeviceStatistics | Concede permissão para obter informações estatísticas para determinado WirelessDevice | Read | |||
| GetWirelessGateway | Concede permissão para obter o WirelessGateway | Read | |||
| GetWirelessGatewayCertificate | Concede permissão para obter o ID do certificado de identidade do IoT Core associado ao WirelessGateway | Read | |||
| GetWirelessGatewayFirmwareInformation | Concede permissão para obter a versão atual do firmware e outras informações para o WirelessGateway | Read | |||
| GetWirelessGatewayStatistics | Concede permissão para obter informações estatísticas de determinado WirelessGateway | Read | |||
| GetWirelessGatewayTask | Concede permissão para obter a tarefa de determinado WirelessGateway | Read | |||
| GetWirelessGatewayTaskDefinition | Concede permissão para obter a definição de tarefa fornecida do WirelessGateway | Leitura | |||
| ListDestinations | Concede permissão para listar informações de Destinations disponíveis com base na Conta da AWS | Leitura | |||
| ListDeviceProfiles | Concede permissão para listar informações de DeviceProfiles disponíveis com base na Conta da AWS | Leitura | |||
| ListDevicesForWirelessDeviceImportTask | Concede permissão para listar as informações de dispositivos por tarefa de importação de dispositivo sem fio com base na Conta da AWS | Leitura | |||
| ListEventConfigurations | Concede permissão para listar informações de configurações de eventos disponíveis com base na Conta da AWS | Leitura | |||
| ListFuotaTasks | Concede permissão para listar informações de FuotaTasks disponíveis com base na Conta da AWS | Leitura | |||
| ListMulticastGroups | Concede permissão para listar informações de MulticastGroups disponíveis com base na Conta da AWS | Leitura | |||
| ListMulticastGroupsByFuotaTask | Concede permissão para listar informações de MulticastGroups disponíveis pela FuotaTask com base na Conta da AWS | Leitura | |||
| ListNetworkAnalyzerConfigurations | Concede permissão para listar informações de NetworkAnalyzerConfigurations disponíveis, com base na Conta da AWS | Leitura | |||
| ListPartnerAccounts | Concede permissão para listar as contas de parceiros disponíveis | Leitura | |||
| ListPositionConfigurations | Concede permissão para listar informações de configurações de posição disponíveis com base na Conta da AWS | Leitura | |||
| ListQueuedMessages | Concede permissão para listar as mensagens na fila | Leitura | |||
| ListServiceProfiles | Concede permissão para listar informações de ServiceProfiles disponíveis com base na Conta da AWS | Leitura | |||
| ListTagsForResource | Concede permissão para listar todas as etiquetas para determinado recurso | Leitura | |||
| ListWirelessDeviceImportTasks | Concede permissão para listar informações de tarefas de importação de dispositivo sem fio com base na Conta da AWS | Leitura | |||
| ListWirelessDevices | Concede permissão para listar informações de WirelessDevices disponíveis com base na Conta da AWS | Leitura | |||
| ListWirelessGatewayTaskDefinitions | Concede permissão para listar as informações das definições de tarefas disponíveis do WirelessGateway com base na Conta da AWS | Leitura | |||
| ListWirelessGateways | Concede permissão para listar as informações dos WirelessGateways disponíveis com base na Conta da AWS | Leitura | |||
| PutPositionConfiguration | Concede permissão para colocar a configuração de posição de um determinado recurso | Gravar | |||
| PutResourceLogLevel | Concede permissão para colocar o nível de log de recursos | Write | |||
| ResetAllResourceLogLevels | Concede permissão para redefinir todos os níveis de log de recursos | Write | |||
| ResetResourceLogLevel | Concede permissão para redefinir o nível de log de recursos | Gravar | |||
| SendDataToMulticastGroup | Concede permissão para enviar dados ao MulticastGroup | Gravar | |||
| SendDataToWirelessDevice | Concede permissão para enviar o quadro de dados da aplicação descriptografado para o dispositivo de destino | Gravar | |||
| StartBulkAssociateWirelessDeviceWithMulticastGroup | Concede permissão para associar o WirelessDevices a MulticastGroup | Gravar | |||
| StartBulkDisassociateWirelessDeviceFromMulticastGroup | Concede permissão para desassociar em massa o WirelessDevices do MulticastGroup | Gravar | |||
| StartFuotaTask | Concede permissão para iniciar a FuotaTask | Gravar | |||
| StartMulticastGroupSession | Concede permissão para iniciar a sessão MulticastGroup | Gravar | |||
| StartNetworkAnalyzerStream | Concede permissão para iniciar a transmissão do NetworkAnalyzer | Gravar | |||
| StartSingleWirelessDeviceImportTask | Concede permissão para iniciar a única tarefa de importação de dispositivos sem fio | Gravar | |||
| StartWirelessDeviceImportTask | Concede permissão para iniciar a tarefa de importação de dispositivos sem fio | Gravar | |||
| TagResource | Concede permissão para marcar determinado recurso | Marcação | |||
| TestWirelessDevice | Concede permissão para simular um dispositivo provisionado para enviar dados de uplink com carga útil de "Hello" | Write | |||
| UntagResource | Concede permissão para remover as etiquetas fornecidas do recurso | Marcação | |||
| UpdateDestination | Concede permissão para atualizar um recurso de destino | Gravar | |||
| UpdateEventConfigurationByResourceTypes | Concede permissão para atualizar a configuração de evento por tipos de recurso | Gravar | |||
| UpdateFuotaTask | Concede permissão para atualizar o FuotaTask | Gravar | |||
| UpdateLogLevelsByResourceTypes | Concede permissão para atualizar níveis de log por tipos de recurso | Gravar | |||
| UpdateMetricConfiguration | Concede permissão para atualizar uma configuração de métrica | Gravar | |||
| UpdateMulticastGroup | Concede permissão para atualizar o MulticastGroup | Gravar | |||
| UpdateNetworkAnalyzerConfiguration | Concede permissão para atualizar o NetworkAnalyzerConfiguration | Gravar | |||
| UpdatePartnerAccount | Concede permissão para atualizar uma conta de parceiro | Gravar | |||
| UpdatePosition | Concede permissão para atualizar a posição de um determinado recurso | Gravar | |||
| UpdateResourceEventConfiguration | Concede permissão para atualizar uma configuração de evento para um identificador | Gravar | |||
| UpdateResourcePosition | Concede permissão para atualizar a posição de um determinado recurso | Gravar | |||
| UpdateWirelessDevice | Concede permissão para atualizar um recurso WirelessDevice | Gravar | |||
| UpdateWirelessDeviceImportTask | Concede permissão para atualizar uma tarefa de importação de dispositivos sem fio | Gravar | |||
| UpdateWirelessGateway | Concede permissão para atualizar um recurso WirelessGateway | Gravar |
Tipos de recursos definidos pelo AWS IoT Wireless
Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.
| Tipos de recursos | ARN | Chaves de condição |
|---|---|---|
| WirelessDevice |
arn:${Partition}:iotwireless:${Region}:${Account}:WirelessDevice/${WirelessDeviceId}
|
|
| WirelessGateway |
arn:${Partition}:iotwireless:${Region}:${Account}:WirelessGateway/${WirelessGatewayId}
|
|
| DeviceProfile |
arn:${Partition}:iotwireless:${Region}:${Account}:DeviceProfile/${DeviceProfileId}
|
|
| ServiceProfile |
arn:${Partition}:iotwireless:${Region}:${Account}:ServiceProfile/${ServiceProfileId}
|
|
| Destination |
arn:${Partition}:iotwireless:${Region}:${Account}:Destination/${DestinationName}
|
|
| SidewalkAccount |
arn:${Partition}:iotwireless:${Region}:${Account}:SidewalkAccount/${SidewalkAccountId}
|
|
| WirelessGatewayTaskDefinition |
arn:${Partition}:iotwireless:${Region}:${Account}:WirelessGatewayTaskDefinition/${WirelessGatewayTaskDefinitionId}
|
|
| FuotaTask |
arn:${Partition}:iotwireless:${Region}:${Account}:FuotaTask/${FuotaTaskId}
|
|
| MulticastGroup |
arn:${Partition}:iotwireless:${Region}:${Account}:MulticastGroup/${MulticastGroupId}
|
|
| NetworkAnalyzerConfiguration |
arn:${Partition}:iotwireless:${Region}:${Account}:NetworkAnalyzerConfiguration/${NetworkAnalyzerConfigurationName}
|
|
| thing |
arn:${Partition}:iot:${Region}:${Account}:thing/${ThingName}
|
|
| cert |
arn:${Partition}:iot:${Region}:${Account}:cert/${Certificate}
|
|
| ImportTask |
arn:${Partition}:iotwireless:${Region}:${Account}:ImportTask/${ImportTaskId}
|
Chaves de condição do AWS IoT Wireless
O AWS IoT Wireless define as chaves de condição a seguir que podem ser usadas no elemento Condition de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.
Para exibir as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de contexto de condição globais da AWS.
| Chaves de condição | Descrição | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra o acesso por uma chave da etiqueta que está presente na solicitação que o usuário faz ao IoT Wireless. | String |
| aws:ResourceTag/${TagKey} | Filtra o acesso por componente chave da etiqueta de uma etiqueta associada a um recurso IoT Wireless | String |
| aws:TagKeys | Filtra o acesso pela lista de todos os nomes de chave da etiqueta associados ao recurso na solicitação | ArrayOfString |