Smtp Usernames - Create Or Update

Служба:: Communication

Версия API:: 2025-05-01-preview

Создайте или обновите SmtpUsernameResource.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}/smtpUsernames/{smtpUsername}?api-version=2025-05-01-preview

Параметры URI

Имя	В	Обязательно	Тип	Описание
communicationServiceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[-\w]+$	Имя ресурса CommunicationService.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
smtpUsername	path	True	string minLength: 1 maxLength: 253 pattern: ^[a-zA-Z0-9-]+$	Имя ресурса SmtpUsernameResource.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Обязательно	Тип	Описание
properties.entraApplicationId	True	string (uuid)	Идентификатор приложения для связанного приложения Entra.
properties.tenantId	True	string (uuid)	Клиент связанного приложения Entra.
properties.username	True	string	Имя пользователя SMTP. Может быть свободной формой или в формате адреса электронной почты.

Ответы

Имя	Тип	Описание
200 OK	SmtpUsernameResource	Ресурс был успешно обновлен.
201 Created	SmtpUsernameResource	Ресурс был успешно создан.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Примеры

CreateOrUpdate SmtpUsername resource

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/contosoResourceGroup/providers/Microsoft.Communication/communicationServices/contosoACSService/smtpUsernames/smtpusername1?api-version=2025-05-01-preview

{
  "properties": {
    "username": "newuser1@contoso.com",
    "entraApplicationId": "aaaa1111-bbbb-2222-3333-aaaa111122bb",
    "tenantId": "aaaa1111-bbbb-2222-3333-aaaa11112222"
  }
}

Пример ответа

Код состояния:: 200

{
  "id": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/contosoResourceGroup/providers/Microsoft.Communication/CommunicationServices/contosoACSService/SmtpUsername/smtpusername1",
  "name": "smtpusername1",
  "type": "Microsoft.Communication/CommunicationServices/SmtpUsername",
  "properties": {
    "username": "newuser1@contoso.com",
    "entraApplicationId": "aaaa1111-bbbb-2222-3333-aaaa1111abcd",
    "tenantId": "aaaa1111-bbbb-2222-3333-aaaa11112222"
  }
}

Код состояния:: 201

{
  "id": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/contosoResourceGroup/providers/Microsoft.Communication/CommunicationServices/contosoACSService/SmtpUsername/smtpusername1",
  "name": "smtpusername1",
  "type": "Microsoft.Communication/CommunicationServices/SmtpUsername",
  "properties": {
    "username": "newuser1@contoso.com",
    "entraApplicationId": "aaaa1111-bbbb-2222-3333-aaaa1111abcd",
    "tenantId": "aaaa1111-bbbb-2222-3333-aaaa11112222"
  }
}

Код состояния:: default

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
SmtpUsernameResource	Объект, описывающий ресурс имени пользователя smtp.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

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

Значение	Описание
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

SmtpUsernameResource

Object

Объект, описывающий ресурс имени пользователя smtp.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.entraApplicationId	string (uuid)	Идентификатор приложения для связанного приложения Entra.
properties.tenantId	string (uuid)	Клиент связанного приложения Entra.
properties.username	string	Имя пользователя SMTP. Может быть свободной формой или в формате адреса электронной почты.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

systemData

Object

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

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

Поделиться через

Smtp Usernames - Create Or Update

Параметры URI

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

Ответы

Примеры

CreateOrUpdate SmtpUsername resource

Образец запроса

Пример ответа

Определения

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SmtpUsernameResource

systemData