Dev Boxes - List Schedules By Pool

Servicio:

Dev Center

Versión de la API:

2025-02-01

Enumera todas las programaciones de un grupo configurado por el administrador del proyecto.

GET {endpoint}/projects/{projectName}/pools/{poolName}/schedules?api-version=2025-02-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	URI específico de DevCenter en el que se va a operar.
poolName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nombre de un grupo de Dev Boxes.
projectName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Proyecto de DevCenter sobre el que se van a ejecutar las operaciones.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	PagedSchedule	La solicitud se ha realizado correctamente.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
https://devcenter.azure.com/.default

Ejemplos

Lists all schedules within a pool that are configured by your project administrator.

Solicitud de ejemplo

HTTP

GET https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/projects/myProject/pools/DevPool/schedules?api-version=2025-02-01

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "uri": "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/projects/myProject/pools/DevPool/schedules/default",
      "name": "default",
      "sourceUri": "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/projects/myProject/pools/DevPool",
      "sourceType": "Pool",
      "type": "StopDevBox",
      "timeZone": "America/Los_Angeles",
      "frequency": "Daily",
      "time": "17:30"
    }
  ]
}

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
PagedSchedule	Colección paginada de elementos schedule
Schedule	Una acción Programar para ejecutar.
ScheduledFrequency	Frecuencia de ejecución de tareas.
ScheduledType	Los tipos admitidos para una tarea programada.
ScheduleSourceType	Tipo del recurso al que pertenece esta programación.

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

PagedSchedule

Object

Colección paginada de elementos schedule

Nombre	Tipo	Description
nextLink	string (uri)	Vínculo a la página siguiente de elementos
value	Schedule[]	Los elementos Programación de esta página

Schedule

Object

Una acción Programar para ejecutar.

Nombre	Tipo	Description
frequency	ScheduledFrequency	Frecuencia de esta tarea programada.
name	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nombre para mostrar de schedule.
sourceType	ScheduleSourceType	Tipo del recurso al que pertenece esta programación.
sourceUri	string (uri)	Identificador URI del recurso al que pertenece esta programación.
time	string	Hora de destino para desencadenar la acción. El formato es HH:MM.
timeZone	string	Identificador de zona horaria de IANA en el que se debe ejecutar la programación.
type	ScheduledType	Tipo admitido que representa esta tarea programada.
uri	string (uri)	Identificador URI único de la programación.

ScheduledFrequency

Enumeración

Frecuencia de ejecución de tareas.

Valor	Description
Daily	La tarea programada se ejecutará todos los días.

ScheduledType

Enumeración

Los tipos admitidos para una tarea programada.

Valor	Description
StopDevBox	La tarea programada detendrá los cuadros de desarrollo afectados.

ScheduleSourceType

Enumeración

Tipo del recurso al que pertenece esta programación.

Valor	Description
Pool	El origen de la programación es un grupo de Dev Box.