Hybrid Runbook Worker Group - Create

Ссылка

Service:: Automation

API Version:: 2021-06-22

Создайте гибридную рабочую группу Runbook.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22

Параметры URI

Name	In	Required	Type	Description
automationAccountName	path	True	string	Имя учетной записи службы автоматизации.
hybridRunbookWorkerGroupName	path	True	string	Имя группы гибридных рабочих ролей Runbook
resourceGroupName	path	True	string	Имя группы ресурсов Azure. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Возвращает учетные данные подписки, которые уникально идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.
api-version	query	True	string	Версия API клиента.

Текст запроса

Name	Type	Description
credential	RunAsCredentialAssociationProperty	Задает учетные данные рабочей группы.

Ответы

Name	Type	Description
200 OK	HybridRunbookWorkerGroup	ОК
Other Status Codes	ErrorResponse	Ответ об ошибке службы автоматизации, описывающий причину сбоя операции.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create a hybrid worker group

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/testaccount/hybridRunbookWorkerGroups/TestHybridGroup?api-version=2021-06-22

{
  "credential": {
    "name": "myRunAsCredentialName"
  }
}

package armautomation_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/automation/armautomation"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/automation/resource-manager/Microsoft.Automation/stable/2021-06-22/examples/putHybridRunbookWorkerGroup.json
func ExampleHybridRunbookWorkerGroupClient_Create() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armautomation.NewHybridRunbookWorkerGroupClient("subid", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := client.Create(ctx,
		"rg",
		"testaccount",
		"TestHybridGroup",
		armautomation.HybridRunbookWorkerGroupCreateOrUpdateParameters{
			Credential: &armautomation.RunAsCredentialAssociationProperty{
				Name: to.Ptr("myRunAsCredentialName"),
			},
		},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/testaccount/hybridRunbookWorkerGroups/TestHybridGroup",
  "name": "TestHybridGroup",
  "credential": {
    "name": "myRunAsCredentialName"
  },
  "groupType": "User",
  "systemData": {
    "createdBy": "foo@contoso.com",
    "createdByType": "User",
    "createdAt": "2018-04-24T16:30:55+00:00",
    "lastModifiedBy": "foo@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-04-24T16:30:55+00:00"
  }
}

Определения

createdByType	Тип удостоверения, создавшего ресурс.
ErrorResponse	Ответ об ошибке при сбое операции
GroupTypeEnum	Тип HybridWorkerGroup.
HybridRunbookWorkerGroup	Определение гибридной рабочей роли Runbook.
HybridRunbookWorkerGroupCreateOrUpdateParameters	Параметры, предоставленные для операции создания или обновления гибридной рабочей группы runbook.
HybridRunbookWorkerLegacy	Определение гибридной рабочей роли Runbook прежних версий.
RunAsCredentialAssociationProperty	Определение учетных данных запуска от имени, используемых для гибридной рабочей роли.
systemData	Метаданные, относящиеся к созданию и последнему модификации ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorResponse

Ответ об ошибке при сбое операции

Name	Type	Description
code	string	Код ошибки
message	string	Сообщение об ошибке, указывающее, почему операция завершилась сбоем.

GroupTypeEnum

Тип HybridWorkerGroup.

Name	Type	Description
System	string
User	string

HybridRunbookWorkerGroup

Определение гибридной рабочей роли Runbook.

Name	Type	Description
credential	RunAsCredentialAssociationProperty	Задает учетные данные рабочей группы.
groupType	GroupTypeEnum	Тип HybridWorkerGroup.
hybridRunbookWorkers	HybridRunbookWorkerLegacy[]	Возвращает или задает список гибридных рабочих ролей Runbook.
id	string	Возвращает или задает идентификатор ресурса.
name	string	Получает или задает имя группы.
systemData	systemData	Метаданные системы ресурсов.
type	string	Тип ресурса.

HybridRunbookWorkerGroupCreateOrUpdateParameters

Параметры, предоставленные для операции создания или обновления гибридной рабочей группы runbook.

Name	Type	Description
credential	RunAsCredentialAssociationProperty	Задает учетные данные рабочей группы.

HybridRunbookWorkerLegacy

Определение гибридной рабочей роли Runbook прежних версий.

Name	Type	Description
ip	string	Возвращает или задает НАЗНАЧЕННЫй IP-адрес компьютера.
lastSeenDateTime	string	Последний пульс из рабочей роли
name	string	Возвращает или задает имя рабочего компьютера.
registrationTime	string	Возвращает или задает время регистрации рабочего компьютера.

RunAsCredentialAssociationProperty

Определение учетных данных запуска от имени, используемых для гибридной рабочей роли.

Name	Type	Description
name	string	Возвращает или задает имя учетных данных.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

Name	Type	Description
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое последнее изменение ресурса.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.