Schedules - List

Služba:: Dev Test Labs

Verze rozhraní API:: 2018-09-15

Vypisujte plány v daném testovacím prostředí.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules?api-version=2018-09-15

S volitelnými parametry:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules?api-version=2018-09-15&$expand={$expand}&$filter={$filter}&$top={$top}&$orderby={$orderby}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
labName	path	True	string	laboratoře
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$expand	query		string	Zadejte dotaz $expand. Příklad: 'properties($select=status)'
$filter	query		string	Filtr, který se má použít pro operaci. Příklad: '$filter=contains(name;'myName')
$orderby	query		string	Výraz řazení výsledků pomocí notace OData. Příklad: '$orderby=name desc'
$top	query		integer (int32)	Maximální počet prostředků, které se mají vrátit z operace. Příklad: '$top=10'

Odpovědi

Name	Typ	Description
200 OK	ScheduleList	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Schedules_List

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/schedules?api-version=2018-09-15

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "name": "{scheduleName}",
      "type": "Microsoft.DevTestLab/labs/schedules",
      "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/schedules/{scheduleName}",
      "location": "{location}",
      "properties": {
        "createdDate": "2018-10-01T18:40:48.1739018-07:00",
        "dailyRecurrence": {
          "time": "{timeOfTheDayTheScheduleWillOccurEveryDay}"
        },
        "hourlyRecurrence": {
          "minute": 30
        },
        "notificationSettings": {
          "emailRecipient": "{email}",
          "notificationLocale": "EN",
          "status": "{Enabled|Disabled}",
          "timeInMinutes": 15,
          "webhookUrl": "{webhookUrl}"
        },
        "provisioningState": "Creating",
        "status": "{Enabled|Disabled}",
        "targetResourceId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
        "taskType": "{myLabVmTaskType}",
        "timeZoneId": "Pacific Standard Time",
        "uniqueIdentifier": "{uniqueIdentifier}",
        "weeklyRecurrence": {
          "time": "{timeOfTheDayTheScheduleWillOccurOnThoseDays}",
          "weekdays": [
            "Monday",
            "Wednesday",
            "Friday"
          ]
        }
      },
      "tags": {
        "tagName1": "tagValue1"
      }
    }
  ]
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DayDetails	Vlastnosti denního plánu
EnableStatus	Označuje, jestli je zdroj artefaktů povolený (hodnoty: Povoleno, Zakázáno).
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
HourDetails	Vlastnosti hodinového plánu
NotificationSettings	Nastavení oznámení pro plán
Schedule	Plán.
ScheduleList	Odpověď operace seznamu.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
WeekDetails	Vlastnosti týdenního plánu

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DayDetails

Objekt

Vlastnosti denního plánu

Name	Typ	Description
time	string	Nastane čas v den, kdy bude plán probíhat.

EnableStatus

Výčet

Označuje, jestli je zdroj artefaktů povolený (hodnoty: Povoleno, Zakázáno).

Hodnota	Description
Enabled
Disabled

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

HourDetails

Objekt

Vlastnosti hodinového plánu

Name	Typ	Description
minute	integer (int32)	Minuty hodiny, po které se plán spustí.

NotificationSettings

Objekt

Nastavení oznámení pro plán

Name	Typ	Default value	Description
emailRecipient	string		Příjemce e-mailu, na který se mají odesílat oznámení (může to být seznam středník oddělených e-mailových adres).
notificationLocale	string		Národní prostředí, které se má použít při odesílání oznámení (záložní pro nepodporované jazyky je EN).
status	EnableStatus	Disabled	Pokud jsou pro tento plán povolená oznámení (tj. Povoleno, Zakázáno).
timeInMinutes	integer (int32)		Čas v minutách před událostí, ve které se oznámení odešle.
webhookUrl	string		Adresa URL webhooku, na kterou se oznámení odešle.

Schedule

Objekt

Plán.

Name	Typ	Default value	Description
id	string		Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Geografická poloha, kde se prostředek nachází
name	string		Název prostředku
properties.createdDate	string (date-time)		Datum vytvoření plánu.
properties.dailyRecurrence	DayDetails		Pokud plán nastane jednou denně v týdnu, zadejte denní opakování.
properties.hourlyRecurrence	HourDetails		Pokud bude plán probíhat vícekrát denně, zadejte hodinové opakování.
properties.notificationSettings	NotificationSettings		Nastavení oznámení
properties.provisioningState	string		Stav zřizování prostředku.
properties.status	EnableStatus	Disabled	Stav plánu (tj. Povoleno, Zakázáno)
properties.targetResourceId	string		ID prostředku, do kterého plán patří
properties.taskType	string		Typ úkolu plánu (např. LabVmsShutdownTask, LabVmAutoStart).
properties.timeZoneId	string		ID časového pásma (např. Standardní čas Číny, Standardní čas Greenlandu, Tichomoří (běžný čas) atd.). Možné hodnoty této vlastnosti najdete v `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)
properties.uniqueIdentifier	string		Jedinečný neměnný identifikátor prostředku (GUID).
properties.weeklyRecurrence	WeekDetails		Pokud bude plán probíhat pouze v některých dnech v týdnu, zadejte týdenní opakování.
systemData	systemData		Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object		Značky prostředků
type	string		Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

ScheduleList

Objekt

Odpověď operace seznamu.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	Schedule[]	Položky plánu na této stránce

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

WeekDetails

Objekt

Vlastnosti týdenního plánu

Name	Typ	Description
time	string	Nastane čas v den, kdy bude plán probíhat.
weekdays	string[]	Dny v týdnu, pro které je plán nastavený (např. neděle, pondělí, úterý atd.).

Sdílet prostřednictvím

Schedules - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Schedules_List

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

DayDetails

EnableStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HourDetails

NotificationSettings

Schedule

ScheduleList

systemData

WeekDetails