GetSwitchRegionDetail - Security Center: Central de Documentação do Alibaba Cloud

Consulta o progresso de uma alternância de serviço. Por exemplo, quando uma conexão de servidor está sendo migrada da China para Singapura, esta operação obtém o progresso e o status da migração.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

yundun-sas:GetSwitchRegionDetail

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Lang	string	Não	O tipo de idioma das mensagens de solicitação e resposta. Valor padrão: zh. Valores válidos: zh: Chinês. en: Inglês.	en
Type	string	Não	O tipo de alternância de serviço. Valores válidos: sg_switch: A conexão do servidor é migrada da China para Singapura. sls_meta_version_switch_stage_1: A alternância de atualização do campo de entrega de análise de logs.	sg_switch

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	PlainResult
Data	object	Os dados da resposta.
IsAgree	string	Indica se a migração é aceita.	true
GmtIsAgreeModified	integer	A hora em que a operação de autorização foi modificada.	1692858597000
IsNoticed	string	Indica se a notificação foi enviada.	YES
GmtNoticed	integer	A hora da notificação.	1692858597000
RegionStatus	array<object>	O status de alternância da região.
	object	Os dados.
EcsCount	integer	The number of ECS instances.	27
RegionId	string	The region where the server resides.	us-east-1
Status	integer	The migration status. Valid values: 0: waiting for migration 1: switchover succeeded.	0
GmtPlanSwitchTime	integer	The planned migration time.	1692858597000
NeedSwitch	boolean	Indica se uma alternância para o novo console é necessária. true: Uma alternância para o novo console é necessária. false: O console legado ainda está em uso.	true
NeedNotice	boolean	Indica se uma notificação pop-up precisa ser exibida para o usuário. true: Uma notificação pop-up precisa ser exibida. false: Nenhuma notificação pop-up precisa ser exibida.	false
RequestId	string	O ID da solicitação. A China continental gera um identificador exclusivo para cada solicitação, que pode ser usado para solução de problemas e diagnósticos.	30CBF632-109F-596F-97F2-451C8B2A****

Exemplos

Resposta de sucesso

JSON formato

{
  "Data": {
    "IsAgree": "true",
    "GmtIsAgreeModified": 1692858597000,
    "IsNoticed": "YES",
    "GmtNoticed": 1692858597000,
    "RegionStatus": [
      {
        "EcsCount": 27,
        "RegionId": "us-east-1",
        "Status": 0,
        "GmtPlanSwitchTime": 1692858597000
      }
    ],
    "NeedSwitch": true,
    "NeedNotice": false
  },
  "RequestId": "30CBF632-109F-596F-97F2-451C8B2A****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	ServerError	ServerError
403	NoPermission	caller has no permission

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.