DescribeLiveUserDomains - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Descrição da operação

Observações de uso

Use esta operação para consultar todos os nomes de domínio do ApsaraVideo Live associados à sua conta Alibaba Cloud. Os tipos de domínio compatíveis incluem domínios de streaming e domínios de ingestão de borda.

Limite de QPS

O limite desta operação é de 100 chamadas por segundo por conta. O sistema descarta solicitações que excederem esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar a API. Para mais informações, consulte Limites de QPS.

Depuração

Execute esta interface diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após a execução bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código SDK.

Depurar

Informações de autorização

A tabela a seguir apresenta as informações de autorização correspondentes à API. Use esses dados no elemento de política Action para conceder permissões a um usuário RAM ou função RAM e permitir a chamada desta operação da API. Descrição:

Operação: valor usado no elemento Action para especificar a ação sobre um recurso.
Nível de acesso: define o nível de acesso de cada operação. Os níveis disponíveis são leitura, escrita e listagem.
Tipo de recurso: indica o tipo de recurso no qual o usuário RAM ou a função RAM tem autorização para executar a operação. Observe os seguintes pontos:
- Tipos de recursos obrigatórios são indicados pelo prefixo * .
- Caso não seja possível conceder permissões no nível do recurso, usa-se All Resources na coluna Tipo de recurso da operação.
Chave de condição: chave de condição definida pelo serviço de nuvem.
Operação associada: outras operações que o usuário RAM ou a função RAM precisa ter permissão para executar a fim de concluir a operação principal. Para finalizar a tarefa, é necessário possuir permissões também nas operações associadas.

Operation	Access level	Resource type	Condition key	Associated operation
live:DescribeLiveUserDomains	get	All Resources ``	none	none

Parâmetros da solicitação

Parameter	Type	Required	Description	Example
LiveDomainType	string	No	Tipo do nome de domínio. Valores válidos: liveVideo: domínio de streaming liveEdge: domínio de ingestão Nota Se este parâmetro for deixado vazio, o sistema consulta por padrão todos os domínios de ingestão e de streaming da sua conta Alibaba Cloud.	liveVideo
PageSize	integer	No	Número de entradas por página. Valor padrão: 20. Valor máximo: 50.	20
PageNumber	integer	No	Número da página. Valores válidos: 1 a 100000.	1
DomainName	string	No	Nome de domínio usado como palavra-chave para filtrar resultados. Compatível com correspondência aproximada. Nota Se você definir LiveDomainType como liveVideo e deixar este parâmetro vazio, o sistema consulta os domínios de streaming. - Se você definir LiveDomainType como liveEdge e deixar este parâmetro vazio, o sistema consulta os domínios de ingestão.	*.aliyundoc.com
RegionName	string	No	ID da região onde o nome de domínio está localizado.	cn-beijing
DomainSearchType	string	No	Modo de pesquisa. Valores válidos: fuzzy_match (padrão): correspondência aproximada pre_match: correspondência de prefixo suf_match: correspondência de sufixo full_match: correspondência exata	fuzzy_match
DomainStatus	string	No	Status do nome de domínio. Valores válidos: online offline configuring	online
Tag	array<object>	No	As tags.
	object	No	Lista de tags.
Key	string	No	Chave da tag.	TestKey
Value	string	No	Valor da tag.	TestValue
ResourceGroupId	string	No	ID do grupo de recursos.	rg-aek2egyoep3jp7a

Parâmetros de resposta

Parameter	Type	Description	Example
	object
Domains	array<object>	Os nomes de domínio.
PageData	object	Informações sobre o nome de domínio.
Cname	string	CNAME gerado para o nome de domínio.	learn.developer.aliyundoc.com
Description	string	A descrição.	test
DomainName	string	O nome de domínio.	demo.aliyundoc.com
GmtCreated	string	Horário de criação do nome de domínio. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.	2017-08-29T12:15:36Z
GmtModified	string	Horário da última modificação do nome de domínio. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.	2017-12-29T12:15:36Z
LiveDomainStatus	string	Status do nome de domínio. Valores válidos: online offline configuring	online
LiveDomainType	string	Tipo do nome de domínio. Valores válidos: liveVideo: domínio de streaming liveEdge: domínio de ingestão	liveVideo
RegionName	string	ID da região onde o nome de domínio está localizado.	cn-beijing
ResourceGroupId	string	ID do grupo de recursos.	rg-aekzvyjetyjjmla
PageNumber	long	Número da página.	1
PageSize	long	Número de entradas por página.	100
RequestId	string	ID da solicitação.	E4EBD2BF-5EB0-4476-8829-9D94E1B15267
TotalCount	long	Número total de entradas.	1

Exemplos

Exemplo de resposta de sucesso

Formato JSON

{

"Domains": {

"PageData": [

{

"Cname": "learn.developer.aliyundoc.com",

"Description": "test",

"DomainName": "demo.aliyundoc.com",

"GmtCreated": "2017-08-29T12:15:36Z",

"GmtModified": "2017-12-29T12:15:36Z",

"LiveDomainStatus": "online",

"LiveDomainType": "liveVideo",

"RegionName": "cn-beijing",

"ResourceGroupId": "rg-aekzvyjetyjjmla"

}

]

},

"PageNumber": 1,

"PageSize": 100,

"RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B15267",

"TotalCount": 1

}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidPageNumber.ValueNotSupported	The specified value of parameter PageNumber is not supported.	O valor especificado para o parâmetro PageNumber não é compatível.
400	InvalidPageSize.ValueNotSupported	The specified value of parameter PageSize is not supported.	-
400	InvalidDomainStatus.ValueNotSupported	The specified value of parameter DomainStatus is not supported.	-
400	InvalidDomainName.Malformed	The specific value of parameter DomainName is malformed.	-
400	InvalidDomainSearchType.ValueNotSupported	The specified value of parameter DomainSearchType is not supported.	-
400	InvalidDomainSearchType.Malformed	he specified value of parameter DomainSearchType is invalid.	-
400	InvalidLiveDomainType.ValueNotSupported	The specified value of parameter LiveDomainType is not supported.	-

Para obter uma lista completa de códigos de erro, visite Códigos de erro do serviço.

Histórico de alterações

Change time	Summary of changes	Operation
2024-09-27	API Description Update. The Error code has changed	Ver detalhes da alteração
2024-09-25	The Error code has changed. The request parameters of the API has changed. The response structure of the API has changed	Ver detalhes da alteração