Todos os produtos
Search
Central de documentação

DataWorks:ListShiftPersonnels

Última atualização: Oct 09, 2026

Obtém a lista de pessoal de plantão para uma escala de turnos.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ShiftScheduleIdentifier

string

Sim

O identificador exclusivo da escala de turnos. Você pode chamar a operação ListShiftSchedules para consultar as escalas de turnos existentes e obter um ShiftScheduleIdentifier válido na resposta.

2ab6456ada634b2f938ee******9b45b

UserType

string

Não

A condição de consulta para o pessoal de plantão. Valores válidos: ALL (todo o pessoal de plantão), PRIMARY (pessoal de plantão principal), BACKUP (pessoal de plantão reserva) e DESIGNATED_USER (usuário designado).

Valores válidos:

  • ALL :

    Todo o pessoal de plantão.

  • BACKUP :

    Pessoal de plantão reserva.

  • DESIGNATED_USER :

    Usuário designado.

  • PRIMARY :

    Pessoal de plantão principal.

ALL

ShiftPersonUID

string

Não

O ID da conta Alibaba Cloud. Você pode fazer login no console do DataWorks e mover o ponteiro sobre a foto do perfil no canto superior direito da barra de menu superior para visualizar o ID da conta.

1933790****551

BeginTime

integer

Sim

A hora de início do turno de plantão. O valor é um timestamp.

1593950832000

EndTime

integer

Sim

A hora de término do turno de plantão. O valor é um timestamp.

1593950832000

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta da API.

RequestId

string

O ID da solicitação. Você pode usar este ID para solucionar problemas quando ocorrerem erros.

0000-ABCD-EFG

Paging

object

O resultado da paginação.

PageNumber

integer

O número da página. Valor mínimo: 1. Valor máximo: 100. Valor padrão: 1.

1

PageSize

integer

O número de entradas por página. Valor padrão: 10. Valor máximo: 100.

10

TotalCount

integer

O número total de entradas que atendem às condições de consulta.

100

ShiftPersons

array<object>

A lista de pessoal de plantão.

object

O pessoal de plantão.

ShiftPersonUID

string

O UID da pessoa de plantão.

3726346****

ShiftPersonName

string

O nome da pessoa de plantão.

Zhang San

BeginTime

integer

A hora de início do ciclo de plantão.

O valor é um timestamp de 13 dígitos, como 1593950832000.

1593950832000

EndTime

integer

A hora de término do ciclo de plantão.

O valor é um timestamp de 13 dígitos, como 1593950832000.

1593950832000

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0000-ABCD-EFG",
  "Paging": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "ShiftPersons": [
      {
        "ShiftPersonUID": "3726346****",
        "ShiftPersonName": "Zhang San",
        "BeginTime": 1593950832000,
        "EndTime": 1593950832000
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.