Экспорт (0) Печать
Развернуть все

Добавление роли

Обновлено: Май 2014 г.

Операция Add Role добавляет виртуальную машину к развертыванию виртуальных машин. Для запуска данной операции нужно наличие существующей облачной службы и развертывания в Microsoft Azure. Для создания облачной службы используйте раздел Создание облачной службы. Для создания развертывания можно использовать раздел Создание развертывания виртуальной машины.

Запрос Add Role можно указать следующим образом. Замените <subscription-id> идентификатором подписки, <cloudservice-name> - именем облачной службы, а <deployment-name> - именем развертывания.

 

Метод URI запроса

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles

Необходимо убедиться, что запрос к службе управления безопасен. Дополнительные сведения см. в разделе Authenticating Service Management Requests.

В следующей таблице описаны заголовки запросов.

 

Заголовок запроса Описание

Content-Type

Обязательно. Задайте для этого заголовка значение application/xml.

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. Этот заголовок должен быть установлен в значение 01.03.12 или на более позднюю дату. Дополнительные сведения о заголовках системы управления версиями см. в разделе Управление версиями службы управления.

Далее приведен формат текста запроса.


<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <RoleName>name-of-the-virtual-machine</RoleName>
  <RoleType>PersistentVMRole</RoleType>
  <ConfigurationSets>
    <ConfigurationSet i:type="WindowsProvisioningConfigurationSet">
      <ConfigurationSetType>WindowsProvisioningConfiguration</ConfigurationType> 
      <ComputerName>name-of-computer</ComputerName>
      <AdminPassword>administrator-password</AdminPassword> 
      <EnableAutomaticUpdates>enable-updates</EnableAutomaticUpdates>  
      <TimeZone>time-zone</TimeZone>
      <DomainJoin>
        <Credentials>
          <Domain>domain-to-join</Domain>
          <Username>user-name-in-the-domain</Username>
          <Password>password-for-the-user-name</Password>
        </Credentials>
        <JoinDomain>domain-to-join</JoinDomain>
        <MachineObjectOU>distinguished-name-of-the-ou</MachineObjectOU>
      </DomainJoin>
      <StoredCertificateSettings>
        <CertificateSetting>
          <StoreLocation>LocalMachine</StoreLocation>
          <StoreName>name-of-store-on-the-machine</StoreName>
          <Thumbprint>certificate-thumbprint</Thumbprint>
        </CertificateSetting>
      </StoredCertificateSettings>
      <WinRM>
        <Listeners>
          <Listener>
            <Protocol>listener-protocol</Protocol>
          </Listener>
          <Listener>
            <CertificateThumbprint>certificate-thumbprint</CertificateThumbprint>
            <Protocol>listener-protocol</Protocol>
          </Listener>
        </Listeners>
      </WinRM>
      <AdminUsername>name-of-administrator-account</AdminUsername>
      <CustomData>base-64-encoded-data</CustomData>
      <AdditionalUnattendContent>
        <Passes>
          <UnattendPass>
            <PassName>name-of-pass</PassName>
            <Components>
              <ComponentName>name-of-component</ComponentName>
              <ComponentSettings>
                <ComponentSetting>
                  <SettingName>name-of-setting</SettingName>
                  <Content>base-64-encoded-XML-content</Content>
                </ComponentSetting>
              </ComponentSettings>
            </Components>
          </UnattendedPass>
        </Passes>
      </AdditionalUnattendedContent>
    </ConfigurationSet>
    <ConfigurationSet i:type="LinuxProvisioningConfigurationSet">
      <ConfigurationSetType>LinuxProvisioningConfiguration</ConfigurationType>
      <HostName>host-name-for-the-virtual-machine</HostName>
      <UserName>new-user-name</UserName> 
      <UserPassword>password-for-the-new-user</UserPassword> 
      <DisableSshPasswordAuthentication>password-authentication</DisableSshPasswordAuthentication>           
      <SSH>
        <PublicKeys>
          <PublicKey>
            <FingerPrint>certificate-fingerprint</FingerPrint>
            <Path>SSH-public-key-storage-location</Path>     
          </PublicKey>
        </PublicKeys>
        <KeyPairs>
          <KeyPair>
            <FingerPrint>certificate-fingerprint</FingerPrint>
            <Path>SSH-public-key-storage-location</Path>
          </KeyPair>
        </KeyPairs>
      </SSH>
      <CustomData>base-64-encoded-data</CustomData>
    </ConfigurationSet>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>          
      <InputEndpoints>
        <InputEndpoint>
          <LoadBalancedEndpointSetName>name-of-load-balanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>
            <IntervalInSeconds>interval-of-probe</IntervalInSeconds>
            <TimeoutInSeconds>timeout-for-probe</TimeoutInSeconds>
          </LoadBalancerProbe>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>
          <EndpointACL>
            <Rules>
              <Rule>
                <Order>priority-of-the-rule</Order>
                <Action>permit-rule</Action>
                <RemoteSubnet>subnet-of-the-rule</RemoteSubnet>
                <Description>description-of-the-rule</Description>
              </Rule>
            </Rules>
          </EndpointACL>  
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
        <PublicIP>
      <PublicIPs>
    </ConfigurationSet>
  </ConfigurationSets>
  <ResourceExtensionReferences>
    <ResourceExtensionReference>
      <ReferenceName>name-of-reference</ReferenceName>
      <Publisher>name-of-publisher</Publisher>
      <Name>name-of-extension</Name>
      <Version>version-of-extension</Version>
      <ResourceExtensionParameterValues>
        <ResourceExtensionParameterValue>
          <Key>name-of-parameter-key</Key>
          <Value>parameter-value</Value>
          <Type>type-of-parameter</Type>
        </ResourceExtensionParameterValue>
      </ResourceExtensionParameterValues>
      <State>state-of-resource</State>
    </ResourceExtensionReference>
  </ResourceExtensionReferences>
  <VMImageName>name-of-vm-image</VMImageName>
  <MediaLocation>path-to-vhd</MediaLocation>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>caching-mode</HostCaching> 
      <DiskLabel>label-of-data-disk</DiskLabel>            
      <DiskName>name-of-disk</DiskName>
      <Lun>logical-unit-number</Lun>
      <LogicalDiskSizeInGB>size-in-gb-of-data-disk</LogicalDiskSizeInGB>            
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>caching-mode</HostCaching>    
    <DiskLabel>label-of-operating-system-disk</DiskLabel>
    <DiskName>name-of-disk</DiskName>                    
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>name-of-source-image</SourceImageName>
    <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>
    <OS>operating-system-of-image</OS>
  </OSVirtualHardDisk>      
  <RoleSize>size-of-virtual-machine</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>   
</PersistentVMRole>

В следующей таблице описываются элементы текста запроса.

 

Имя элемента Описание

RoleName

Обязательно. Задает имя виртуальной машины.

RoleType

Обязательно. Указывает тип используемой роли. Для виртуальных машин должно быть PersistentVMRole.

ConfigurationSets

Необязательно. Содержит коллекцию наборов конфигурации, задающих настройки системы и приложения.

ResourceExtensionReferences

Необязательно. Включает в себя коллекцию расширений ресурса, которые должны быть установлены на виртуальной машине. Этот элемент используется, только если элементу ProvisionGuestAgent задано значение true.

Элемент ResourceExtensionReferences доступен только при использовании версии 01.11.13 или более поздней.

VMImageName

Необязательно. Задает имя образа виртуальной машины, который должен использоваться для создания виртуальной машины. Если этот элемент используется, то не используется элемент ConfigurationSets. Дополнительные сведения см. в Захват образа виртуальной машины.

Элемент VMImageName доступен только при использовании версии 01.02.14 или более поздней.

MediaLocation

Требуется, если виртуальная машина создается из опубликованного образа виртуальной машины. Указывает расположение VHD-файла, который создается, когда VMImageName указывает опубликованный образ

Элемент MediaLocation доступен только при использовании версии 01.05.14 или более поздней.

AvailabilitySetName

Необязательно. Указывает имя коллекции виртуальных машин. Виртуальные машины, заданные в одной группе доступности, выделяются в различных узлах для достижения максимальной доступности. Дополнительные сведения о наборах групп доступности см. в разделе Управление доступностью виртуальных машин.

DataVirtualHardDisks

Необязательно. Содержит параметры, используемые для добавления диска данных к виртуальной машине. При создании виртуальной машины с помощью образа виртуальной машины этот элемент не используется. Дополнительные сведения о дисках с данными см. в статье Управление образами и дисками.

OSVirtualHardDisk

Необязательно. Содержит параметры, используемые для создания диска с операционной системой для виртуальной машины. При создании виртуальной машины с помощью образа виртуальной машины этот элемент не используется.

RoleSize

Необязательно. Указывает размер виртуальной машины. По умолчанию размер задан как «Малый». Дополнительные сведения о размерах виртуальных машин см. в разделе Размеры виртуальных машин и облачных служб в Azure.

ProvisionGuestAgent

Необязательно. Показывает, установлен ли агент виртуальной машины на виртуальной машине. Эта служба должна быть установлена, чтобы на виртуальной машине можно было использовать расширение ресурса.

Возможные значения:

  • true

  • false

Содержит коллекцию наборов конфигурации, задающих параметры конфигурации системы и приложения.

 

Имя элемента Описание

ConfigurationSet

Обязательно. Указывает элементы конфигурации виртуальной машины. Требуется атрибут type, чтобы не допустить записи пароля администратора в файл журнала операции.

ConfigurationSetType

Обязательно. Для создания виртуальной машины необходимо указать по крайней мере один из следующих наборов конфигурации.

  • WindowsProvisioningConfiguration

  • LinuxProvisioningConfiguration

Необязательно. В качестве альтернативы можно указать набор NetworkConfiguration, содержащий метаданные, необходимые для создания конфигурации для виртуальной сети виртуальной машины.

ИмяКомпьютера

Необязательно для конфигурации WindowsProvisioningConfiguration. Задает имя компьютера для виртуальной машины. Если имя компьютера не указано, оно задается как сочетание имени развертывания, имени роли и идентифицирующего номера. Имена компьютеров должны иметь длину от 1 до 15 символов.

AdminPassword

Необязательно для конфигурации WindowsProvisioningConfiguration. Задает пароль для учетной записи администратора на создаваемой виртуальной машине. Если виртуальная машина создается с помощью образа, необходимо указать имя учетной записи администратора для создания на машине с помощью элемента AdminUsername. Чтобы задать пароль создаваемой учетной записи администратора, следует использовать элемент AdminPassword. При создании виртуальной машины с помощью имеющегося специализированного диска этот элемент не используется, поскольку на диске уже существует такая учетная запись.

EnableAutomaticUpdates

Необязательно для конфигурации WindowsProvisioningConfiguration. Указывает, включено ли автоматическое обновление виртуальной машины. Обновления происходят в произвольные моменты времени между 3:00 и 5:00.

Возможные значения:

  • true

  • false

Значение по умолчанию - true.

TimeZone

Необязательно для конфигурации WindowsProvisioningConfiguration. Указывает часовой пояс для виртуальной машины.

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

  • См. значения, перечисленные в записи реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.

  • Вывести допустимое время можно с помощью средства командной строки tzutil.

DomainJoin

Необязательно для конфигурации WindowsProvisioningConfiguration. Содержит свойства, определяющие домен, к которому будет присоединена виртуальная машина.

StoredCertificateSettings

Необязательно для конфигурации WindowsProvisioningConfiguration. Содержит список сертификатов службы, с которыми будет выполняться провизионирование для новой виртуальной машины.

WinRM

Необязательно для конфигурации WindowsProvisioningConfiguration. Содержит параметры конфигурации для службы удаленного управления Windows на виртуальной машине. Это включает удаленное взаимодействие с Windows PowerShell.

Элемент WinRM поддерживается только в версии 2013-03-01 и выше.

AdminUsername

Необязательно для конфигурации WindowsProvisioningConfiguration. Задает имя учетной записи администратора, создаваемой для доступа к виртуальной машине. Если виртуальная машина создается с помощью образа, необходимо указать имя учетной записи администратора для создания с помощью этого элемента. Чтобы задать пароль создаваемой учетной записи администратора, следует использовать элемент AdminPassword. При создании виртуальной машины с помощью имеющегося специализированного диска этот элемент не используется, поскольку на диске уже существует такая учетная запись.

CustomData

Необязательно для конфигурации WindowsProvisioningConfiguration. Указывает строку пользовательских данных в кодировке base-64. Строка в кодировке base-64 кодируется в двоичный массив, который сохраняется в виде файла на виртуальной машине. Максимальная длина двоичного массива - 65 535 байт. Файл сохраняется по пути %SYSTEMDRIVE%\AzureData\CustomData.bin. Если файл уже существует, он перезаписывается. Безопасность в каталоге устанавливается в System:Full Control и Administrators:Full Control.

Элемент CustomData доступен только при использовании версии 01.10.13 или более поздней.

AdditionalUnattendContent

Необязательно. Указывает дополнительную информацию в кодировке base-64 в формате, которая может быть включена в файл Unattend.xml. Дополнительные сведения см. в разделе Обзор файлов ответов.

Элемент AdditionalUnattendContent доступен только при использовании версии 01.04.14 или более поздней.

HostName

Обязательно для конфигурации LinuxProvisioningConfiguration. Задает имя узла для виртуальной машины. Имена узлов должны иметь длину от 1 до 64 символов.

UserName

Обязательно для конфигурации LinuxProvisioningConfiguration. Задает имя учетной записи пользователя, которое нужно создать в группе sudoer виртуальной машины. Имена учетных записей должны иметь длину от 1 до 32 символов.

UserPassword

Обязательно для конфигурации LinuxProvisioningConfiguration. Задает пароль для учетной записи пользователя. Пароли должны иметь длину от 6 до 72 символов.

DisableSshPasswordAuthentication

Необязательно для конфигурации LinuxProvisioningConfiguration. Указывает, отключена ли проверка подлинности с помощью пароля SSH. По умолчанию устанавливается значение true.

Возможные значения:

  • true

  • false

Значение по умолчанию - true.

SSH

Необязательно для конфигурации LinuxProvisioningConfiguration. Указывает открытые ключи и пары ключей для использования с виртуальной машиной.

CustomData

Необязательно для конфигурации LinuxProvisioningConfiguration. Указывает строку пользовательских данных в кодировке base-64. Строка в кодировке base-64 расположена в файле ovf-env.xml в ISO-образе виртуальной машины. Файл копируется в /var/lib/waagent/ovf-env.xml агентом Azure для Linux. Во время подготовки этот агент также помещает данные в кодировке base-64 в папку /var/lib/waagent/CustomData. Максимальная длина двоичного массива - 65 535 байт.

Элемент CustomData доступен только при использовании версии 01.10.13 или более поздней.

InputEndpoints

Необязательно для конфигурации NetworkConfiguration. Содержит коллекцию внешних конечных точек для виртуальной машины.

SubnetNames

Необязательно для конфигурации NetworkConfiguration. Содержит список подсетей, к которым будет принадлежать виртуальная машина.

StaticVirtualNetworkIPAddress

Необязательно. Указывает внутренний IP-адрес для виртуальной машины в виртуальной сети. Если вы указываете этот элемент, необходимо также указать элемент SubnetNames с только одной заданной подсетью. IP-адрес, указанный в этом элементе, должен принадлежать подсети, которая определена в SubnetNames, и не должен быть одним из первых четырех IP-адресов или последним IP-адресом в подсети. Не поддерживается развертывание рабочих и веб-ролей в подсеть, в которой имеются виртуальные машины с заданным значением StaticVirtualNetworkIPAddress.

Элемент StaticVirtualNetworkIPAddress доступен только при использовании версии 01.11.13 или более поздней.

PublicIPs

Необязательно. Содержит публичный IP-адрес, который может использоваться помимо виртуального IP-адреса по умолчанию для виртуальной машины.

Элемент PublicIPs доступен только при использовании версии 01.05.14 или более поздней.

Содержит свойства, определяющие домен, к которому будет присоединена виртуальная машина.

 

Имя элемента Описание

Учетные данные

Необязательно. Указывает учетные данные, используемые для соединения виртуальной машины с доменом.

JoinDomain

Необязательно. Указывает домен, с которым соединяется виртуальная машина.

MachineObjectOU

Необязательно. Указывает имя организационной единицы (LDAP X 500), в которой была создана учетная запись компьютера. Эта учетная запись находится в Active Directory на контроллере домена в домене, к которому присоединяется компьютер.

Пример:

OU=MyOu,OU=MyParentOu,DC=example.com,DC=MyCompany,DC=com

Указывает учетные данные, используемые для соединения виртуальной машины с доменом.

 

Имя элемента Описание

Домен

Необязательно. Задает имя домена, используемого для проверки подлинности учетной записи. Значение представляет собой полное имя домена DNS. Если имя домена не указано, то в параметре Username должно указываться удостоверение имени участника-пользователя (UPN) в формате «пользователь@полное-имя-домена-DNS» или «полное-имя-домена-DNS\имя-пользователя».

Пример:

example.com

Имя пользователя

Обязательно. Указывает имя пользователя в домене, которое можно использовать для соединения с доменом.

Пароль

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

Содержит список сертификатов службы, с которыми будет выполняться провизионирование для новой виртуальной машины. Сохраненные параметры сертификата указывают на сертификаты, которые уже существуют в облачной службе. Перед настройкой сохраненных параметров сертификатов для виртуальной машины необходимо вызвать операцию Add Service Certificate или добавить сертификат через портал управления.

 

Имя элемента Описание

CertificateSetting

Обязательно. Указывает параметры сертификата.

StoreLocation

Обязательно. Указывает расположение хранилища сертификатов на виртуальной машине.

Единственное поддерживаемое значение - LocalMachine.

StoreName

Обязательно. Задает имя хранилища сертификатов, из которого извлекается сертификат.

Например, «My».

Отпечаток

Обязательно. Указывает отпечаток сертификата. Отпечаток сертификата должен указывать существующий сертификат службы.

Содержит параметры конфигурации для службы удаленного управления Windows на виртуальной машине.

 

Имя элемента Описание

Прослушиватели

Обязательно. Включает сбор сведений для включения удаленного Windows PowerShell.

Прослушиватель

Обязательно. Задает протокол и сведения о сертификате для прослушивателя.

Протокол

Указывает протокол прослушивателя.

Возможные значения:

  • Http

  • Https

Регистр учитывается.

CertificateThumbprint

Необязательно. Задает отпечаток сертификата для безопасного соединения. Если это значение не указано, то для виртуальной машины создается и используется самозаверяющий сертификат.

Указывает дополнительную информацию в кодировке base-64 в формате, которая может быть включена в файл Unattend.xml.

 

Имя элемента Описание

PassName

Обязательно. Указывает имя прохода, к которому применяется содержимое. Единственное допустимое значение - oobeSystem.

ComponentName

Обязательно. Указывает имя компонента для настройки с добавленным содержимым. Единственное допустимое значение - Microsoft-Windows-Shell-Setup.

SettingName

Обязательно. Указывает имя настройки, к которой применяется содержимое.

Возможные значения:

  • FirstLogonCommands

  • AutoLogon

Content

Обязательно. Указывает содержимое в формате XML в кодировке base-64, которое добавляется в файл unattend.xml для указанного пути и компонента. XML должен быть менее 4 КБ и должен включать корневой элемент для настройки вставляемой функции.

Указывает открытые ключи и пары ключей для использования с виртуальной машиной.

 

Имя элемента Описание

PublicKeys

Необязательно. Указывает коллекцию открытых ключей SSH.

PublicKey

Обязательно. Указывает открытый ключ.

FingerPrint

Обязательно. Указывает отпечаток SHA1 сертификата X509, связанного с облачной службой, где есть открытый ключ SSH.

Путь

Обязательно. Указывает полный путь к файлу в виртуальной машине, где хранится открытый ключ SSH. Если указанный файл уже существует, то указанный ключ присоединяется к файлу.

Пример:

/home/user/.ssh/authorized_keys

KeyPairs

Обязательно. Указывает коллекцию пар ключей SSH.

KeyPair

Обязательно. Задает пару ключей SSH для установки на виртуальную машину.

FingerPrint

Обязательно. Указывает отпечаток SHA1 сертификата X509, связанного с облачной службой и содержащего пару ключей SSH.

Путь

Обязательно. Указывает полный путь к файлу в виртуальной машине, где хранится закрытый ключ SSH. Файл перезаписывается, если в него записывается несколько ключей. Открытый ключ SSH хранится в том же каталоге и имеет то же имя, что и файл закрытых ключей, но с суффиксом PUB.

Пример:

/home/user/.ssh/id_rsa

Содержит коллекцию внешних конечных точек для виртуальной машины.

 

Имя элемента Описание

InputEndpoint

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

LoadBalancedEndpointSetName

Необязательно. Задает имя набора конечных точек, сбалансированных по нагрузке. Указание этого элемента для конечной точки приводит к его добавлению в набор.

Не устанавливайте это свойство, если добавляете конечную точку для подключения к виртуальной машине через удаленный рабочий стол.

noteПримечание
Имя конечной точки должно быть уникальным в области действия виртуальной машины.

LocalPort

Обязательно. Указывает внутренний порт, который прослушивает виртуальная машина.

Название

Обязательно. Указывает имя внешней конечной точки.

Порт

Обязательно. Указывает внешний порт, используемый конечной точкой.

LoadBalancerProbe

Необязательно. Содержит свойства, определяющие параметры конечной точки, которую подсистема балансировки нагрузки использует для отслеживания доступности этой виртуальной машины, прежде чем пересылать на нее трафик.

LoadBalancerName

Необязательно. Указывает имя встроенной балансировки нагрузки, связанной с данной конечной точкой.

Элемент LoadBalancerName доступен только при использовании версии 01.05.14 или более поздней.

Протокол

Обязательно. Указывает транспортный протокол для конечной точки.

Возможные значения:

  • TCP

  • UDP

Значение по умолчанию - false.

EnableDirectServerReturn

Необязательно. Указывает, использует ли конечная точка функцию «Direct Server Return». Элемент EnableDirectServerReturn не поддерживается для конечных точек RDP, SSH или WinRM и в случае, если общий порт и локальный порт конечной точки различаются. Рекомендуется, чтобы этот элемент использовался только для настройки виртуальных машин для SQL Server и групп доступности AlwaysOn. Дополнительные сведения см. в разделе Высокий уровень доступности и аварийное восстановление для SQL Server в виртуальных машинах Azure.

Возможные значения:

  • true

  • false

Значение по умолчанию - false.

EndpointACL

Необязательно. Содержит коллекцию правил, которые управляют сетевым трафиком к конечной точке.

Элемент EndpointACL доступен только при использовании версии 2013-06-01 или более поздней.

Содержит свойства, определяющие параметры конечной точки, которую подсистема балансировки нагрузки использует для отслеживания доступности этой виртуальной машины, прежде чем пересылать на нее трафик.

 

Имя элемента Описание

Путь

Необязательно. Задает относительный путь для проверки состояния доступности виртуальной машины. Если установлено значение протокола TCP, то данное значение должно быть равно NULL.

Пример:

path

При выборке будет использоваться значение адреса https://example.com/path.

Порт

Необязательно. Указывает порт, используемый при проверке состояния доступности виртуальной машины.

Протокол

Необязательно. Указывает протокол, используемый при проверке состояния доступности виртуальной машины.

Возможные значения:

  • HTTP

  • TCP

IntervalInSeconds

Необязательно. Задает интервал для зонда для подсистемы балансировки нагрузки (в секундах). Минимальное значение составляет 5 секунд. Значение по умолчанию - 15 секунда.

TimeoutInSeconds

Необязательно. Задает время ожидания выборки для подсистемы балансировки нагрузки (в секундах). Минимальное значение составляет 11 секунд. Значение по умолчанию - 31 секунда.

Содержит коллекцию правил, которые управляют входящим сетевым трафиком к конечной точке.

 

Имя элемента Описание

Правила

Обязательно. Указывает коллекцию правил управления доступом. Разрешено самое большее 50 правил.

Правило

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

Заказ

Обязательно. Задает приоритет правила. Значение должно быть в интервале от 0 до 65535. Порядковый номер должен быть уникальным для каждого правила в коллекции. Чем меньше порядковый номер, тем выше приоритет правила.

Действие

Обязательно. Указывает, должен быть разрешен или запрещен трафик, соответствующий правилу.

Возможные значения:

  • permit

  • deny

RemoteSubnet

Обязательно. Задает подсеть для правила. Подсеть должна быть задана в нотации CIDR (Classless Inter-Domain Routing в IPV4) и должна быть действительной подсетью.

Описание

Необязательно. Задает описание для правила. Максимальная длина описания составляет 256 знаков.

Содержит публичный IP-адрес, который может использоваться помимо виртуального IP-адреса по умолчанию для виртуальной машины.

 

Имя элемента Описание

PublicIP

Обязательно. Указывает дополнительный публичный IP-адрес, который может использоваться для связи с виртуальной машиной.

Название

Обязательно. Указывает имя публичного IP-адреса.

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

 

Имя элемента Описание

SubnetName

Обязательно. Указывает имя подсети, к которой принадлежит виртуальная машина.

Содержит параметры, используемые для добавления диска данных к виртуальной машине.

 

Имя элемента Описание

DataVirtualHardDisk

Обязательно. Указывает свойства, которые используются для создания диска данных.

HostCaching

Необязательно. Указывает режим кэширования диска данных для повышения производительности чтения и записи. Задание этого свойства влияет на согласованность диска.

Возможные значения:

  • None

  • ReadOnly

  • ReadWrite

Значение по умолчанию - None.

DiskLabel

Необязательно. Если добавляемый диск уже зарегистрирован в подписке, этот элемент пропускается. Если создается новый диск, в этом элементе предоставляется описание диска. Значение данного элемента можно получить только из кода, и оно не отображается на портале управления.

DiskName

Необязательно. Если добавляемый диск уже зарегистрирован в подписке, то данный элемент используется для определения добавляемого диска. Если новый диск и связанный VHD-диск создаются системой Azure, то этот элемент не используется, и Azure назначает уникальное имя, представляющее собой сочетание имени развертывания, имени роли и идентифицирующего номера.

Имя диска должно содержать только алфавитно-цифровые символы, знаки подчеркивания, точки или дефисы. Имя должно содержать не больше 256 символов. Имя не должно завершаться точкой или дефисом.

Lun

Необязательно. Задает логический номер устройства (LUN) для диска данных. Если диск является первым добавляемым диском, этот элемент необязательный и по умолчанию используется значение 0. Если добавляется более одного диска, этот элемент обязателен.

Можно использовать запрос Получить роль для получения уже используемых LUN-номеров.

Допустимые значения от 0 до 15.

Логический размер диска в ГБ

Необязательно. Указывает объем пустого диска для подключения к виртуальной машине (в гигабайтах). Если добавляемый диск уже зарегистрирован в подписке, этот элемент пропускается. Если диск и VHD-диск при добавлении создается Azure, этот элемент определяет размер нового диска.

Размер виртуальной машины определяет число дисков, которые можно к ней добавить. Дополнительные сведения см. в разделе Размеры виртуальных машин и облачных служб в Azure.

Этот элемент используется с элементом MediaLink.

MediaLink

Необязательно. Если добавляемый диск уже зарегистрирован в подписке или VHD-образ для диска уже существует в хранилище BLOB-объектов, этот элемент пропускается. Если VHD-файла нет в хранилище BLOB-объекта, этот элемент определяет расположение нового VHD-файла, который создается при добавлении нового диска.

Пример:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

SourceMediaLink

Необязательно. Если добавляемый диск уже зарегистрирован в подписке или VHD-образ для диска не существует в хранилище BLOB-объектов, этот элемент пропускается. Если VHD-файл существует в хранилище BLOB-объектов, этот элемент определяет путь к VHD-файлу, по которому регистрируется диск, после чего добавляется к виртуальной машине.

Содержит параметры, используемые для создания диска с операционной системой для виртуальной машины.

 

Имя элемента Описание

HostCaching

Необязательно. Указывает режим кэширования диска с операционной системой. Этот параметр влияет на согласованность и производительность диска ОС.

Возможные значения:

  • ReadOnly

  • ReadWrite

Значение по умолчанию - ReadWrite.

noteПримечание
Изменение этого значения приведет к перезагрузке виртуальной машины.

DiskLabel

Необязательно. Указывает описание диска.

DiskName

Требуется, если для создания виртуальной машины будет использоваться существующий диск. Указывает имя нового или существующего диска. Если этот элемент не указан, то для нового диска назначается уникальное имя, представляющее собой сочетание имени развертывания, имени роли и идентифицирующего номера.

Имя диска должно содержать только алфавитно-цифровые символы, знаки подчеркивания, точки или дефисы. Имя должно содержать не больше 256 символов. Имя не должно завершаться точкой или дефисом.

MediaLink

Требуется, если виртуальная машина создается из образа платформы. Указывает расположение VHD-файла, который создается, если в SourceImageName задан образ платформы. Этот элемент не используется, если виртуальная машина создается с помощью существующего диска.

Пример:

http://contoso.blob.core.windows.net/disks/mydisk.vhd

SourceImageName

Необязательно. Задает имя образа, используемого для создания виртуальной машины. Можно указать пользовательский образ или образ платформы. Образ всегда связан с VHD-файлом, который хранится как страничный BLOB-объект в учетной записи хранения Azure. Если указать образ платформы, будет создан связанный VHD-файл и необходимо использовать элемент MediaLink для указания расположения VHD-файла в хранилище.

RemoteSourceImageLink

Необязательно. Определяет URI места хранения образа ОС, используемого для создания виртуальной машины. Образ всегда связан с VHD-файлом, который хранится как страничный BLOB-объект в учетной записи хранения Windows Azure. Если указать путь к образу с данным элементом, будет создан связанный VHD-файл и необходимо использовать элемент MediaLink для указания расположения VHD-файла в хранилище. Если используется этот элемент, то элемент SourceImageName не используется.

Элемент RemoteSourceImageLink доступен только при использовании версии 01.05.14 или более поздней.

ОС

Требуется, если используется RemoteSourceImageLink. Указывает тип операционной системы, установленной в образе.

Возможные значения:

  • Windows

  • Linux

Включает в себя коллекцию расширений ресурса, которые должны быть установлены на виртуальной машине. Расширение ресурса - это программный компонент, который устанавливается на виртуальной машине. Чтобы можно было установить расширения ресурса, на виртуальной машине должен быть установлен агент виртуальной машины. Дополнительные сведения см. в разделе Управление расширениями.

 

Имя элемента Описание

ResourceExtensionReference

Обязательно. Указывает свойства расширения ресурса, которые должны быть установлены на виртуальной машине.

ReferenceName

Обязательно. Указывает эталонное имя расширения ресурса.

Издатель

Обязательно. Указывает имя издателя, который создал расширение ресурса. Для поиска имени издателя расширения ресурса можно использовать Перечисление расширений ресурсов.

Название

Обязательно. Указывает имя расширения ресурса. Для поиска имен доступных расширений ресурса можно использовать Перечисление расширений ресурсов.

Версия

Обязательно. Указывает версию расширения ресурса. Можно установить * в качестве этого значения, чтобы использовать последнюю версию расширения. Если расширение было недавно добавлено или обновлено, следует убедиться, что ReplicationCompleted имеет значение true, прежде чем можно будет использовать эту версию расширения. Чтобы определить состояние репликации и доступные версии расширения, можно использовать Перечисление версий расширения ресурса.

ResourceExtensionParameterValues

Необязательно. Включает в себя коллекцию параметров, которые передаются расширению ресурса при его установке.

Состояние

Необязательно. Указывает состояние расширения ресурса. Если виртуальная машина создана, можно указать только одно состояние - enable. Это значение по умолчанию, если данный элемент не используется. Дополнительные сведения об отключении или удалении расширения см. в статье Обновление роли.

Включает в себя коллекцию параметров, которые передаются расширению ресурса при его установке.

 

Имя элемента Описание

ResourceExtensionParameterValue

Обязательно. Указывает ключ, значение и тип параметра.

Ключ

Обязательно. Указывает ключ параметра.

Значение

Обязательно. Указывает значение параметра в кодировке base-64. Если конфигурация расширения сформатирована в XML, данное значение проверяется с помощью общедоступной или частной схемы. Используемая схема зависит от значения Type.

Если конфигурация расширения сформатирована в JSON, данное значение должно содержать допустимый объект JSON. Общедоступные или частные схемы не могут использоваться для проверки этого объекта. Использование объекта JSON возможно в версии не ниже 2014-04-01.

Тип

Обязательно. Указывает тип расширения ресурса.

Возможные значения:

  • Public

  • Private

Если это значение равно Private, то параметр не будет возвращен командой Получить развертывание. Можно указать только один общедоступный параметр и один закрытый параметр для максимального количества параметров, равного двум.

Содержит список DNS-серверов, связанных с виртуальной машиной.

 

Имя элемента Описание

DnsServers

Обязательно. Содержит параметры для использования при задании DNS-серверов, используемых виртуальной машиной.

DnsServer

Обязательно. Содержит элементы DNS-сервера Name и Address.

Название

Обязательно. Указывает имя DNS-сервера.

Адрес

Обязательно. Указывает IP-адрес DNS-сервера.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 202 (принято). Сведения о кодах состояния см. в разделе Service Management Status and Error Codes.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют Спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-request-id

Значение, которое однозначно определяет запрос к службе управления. Для асинхронной операции можно вызвать получение состояние операции со значением заголовка, чтобы определить, завершена ли операция, произошел ли в ней сбой, или она все еще выполняется. Дополнительные сведения см. в разделе Tracking Asynchronous Service Management Requests.

Показ:
© 2014 Microsoft