Загрузить определение сервиса (Сервер)

Краткая информация

Загружает и публикует веб-слой, локатор, веб-инструмент, сервис или граф знаний в ArcGIS Online, ArcGIS Enterprise или ArcGIS Server.

Использование

• Этот инструмент загружает и публикует веб-слой, локатор, веб-инструмент, сервис или граф знаний на основе входного определения сервиса.

• Этот инструмент не загружает и не публикует файлы черновика определения сервиса (.sddraft). Если у вас есть черновое определение сервиса, вы можете преобразовать его в организованное определение сервиса с помощью инструмента Разместить сервис.

• Веб-инструменты можно публиковать только в ArcGIS Enterprise. Сервисы геообработки можно публиковать только в ArcGIS Server.

• Локаторы можно публиковать только в ArcGIS Enterprise. Сервисы геокодирования можно публиковать только в ArcGIS Server.

• Графы знаний можно публиковать только в ArcGIS Enterprise 12.0 или более поздней версии.

• Вы можете указать ID элементов при публикации следующих элементов для соответствующих версий ArcGIS Enterprise:

  • Векторный веб-слой, который копирует все данные - ArcGIS Enterprise 10.8.1 или более поздней версии
  • Веб-слой листов - ArcGIS Enterprise 10.8.1 или новее
  • Слой изображения карты - ArcGIS Enterprise 11.2 или более поздней версии
  • Векторный веб-слой, ссылающийся на зарегистрированные данные - ArcGIS Enterprise 11.2 или более поздней версии
  • Слой объектов OGC - ArcGIS Enterprise 11.2 или более поздней версии
  • Слой сервиса WMS - ArcGIS Enterprise 11.2 или более поздней версии
  • Слой сервиса WFS - ArcGIS Enterprise 11.2 или более поздней версии
  • Графы знаний – ArcGIS Enterprise 12.0 или более поздней версии

Параметры

Диалог

Подпись	Описание	Тип данных
Определение сервиса	Файл определения сервиса (.sd), который содержит всю информацию, необходимую для публикации веб-слоя, локатора, веб-инструмента, сервиса или графа знаний.	File
Сервер	Тип сервера. Поддерживаются следующие типы серверов: Мои размещенные сервисы – Используется при публикации размещенного веб-слоя на ArcGIS Online или ArcGIS Enterprise. Введите Мои размещенные сервисы для подключения сервера. Все слова должны начинаться с заглавных букв, и между словами должны быть пробелы. HOSTING_SERVER – Используется при публикации размещенного веб-слоя на ArcGIS Online или ArcGIS Enterprise. Адрес URL интегрированного сервера портала ArcGIS Enterprise – используйте при публикации слоя изображений карты на интегрированном сервере портала ArcGIS Enterprise. Подключение ArcGIS Server – используйте при публикации картографического сервиса или сервиса геообработки на ArcGIS Server. Вы можете использовать подключения ArcGIS Server, перечисленные в узле Серверы в окне Проект, или перейти в другую папку, где могут храниться файлы подключения к серверу. URL-адрес ArcGIS Server – используется при публикации картографического сервиса или сервиса геообработки на ArcGIS Server. Вы можете указать URL ArcGIS Server при условии, что в проект ArcGIS Pro было добавлено подключение издателя к ArcGIS Server, и что вы открываете этот проект в скрипте или запускаете инструмент в ArcGIS Pro. KNOWLEDGE_SERVER—Использовать при публикации графа знаний в ArcGIS Enterprise 12.0 или более поздней версии.	ServerConnection
Имя сервиса (Дополнительный)	Имя сервиса, которое перезапишет текущее имя сервиса, указанное в определении сервиса.	String
Кластер (Дополнительный)	Имя кластера, которое перезапишет текущий кластер, которому был назначен сервис. Вы должны выбрать из кластеров на указанном сервере. Прежние версии: Кластеры в ArcGIS Enterprise 10.5.1 признаны устаревшими. Этот параметр будет проигнорирован серверами, которые не поддерживают множественные кластеры.	String
Тип папки (Дополнительный)	Задает тип папки, который используется для определения источника для папки. По умолчанию папка поступает из определения сервиса. Вы также можете получить список папок, существующих на указанном сервере, или задать новую папку, которая будет создана после публикации этого веб-слоя, сервиса или графа знаний. Новое—Будет создана новая папка. Существующий—Будет использоваться существующая папка на сервере. Из определения сервиса—Будет использоваться папка из определения сервиса. Это значение по умолчанию	String
Папка (Дополнительный)	Папка, которая будет использоваться для веб-слоя, сервиса или графа знаний. Если папка не указана, то будет использоваться папка, указанная в определении сервиса. Если вы выбрали Тип папки Новая, используйте этот параметр, чтобы ввести новое имя папки. Если вы выбрали Тип папки Существующая, вы можете выбрать одну из папок, существующих на сервере.	String
Запустить сервис сейчас (Дополнительный)	Определяет, будет ли сервис запущен после публикации. Отмечено – сервис запускается после публикации. Это значение по умолчанию Не отмечено – сервис не запускается после публикации.	Boolean
Заменить свойства общего доступа к описанию сервиса (Дополнительный)	Задает, будут ли перезаписываться настройки общего доступа, заданные в определении сервиса. Эти свойства определяют, будете ли вы публиковать и каким образом веб-слой, веб-инструмент или граф знаний с помощью ArcGIS Online или ArcGIS Enterprise. Отмечено - настройки общего доступа, заданные в определении сервиса, будут перезаписаны. Не отмечено - настройки общего доступа, заданные в определении сервиса, не будут перезаписаны, они будут использоваться. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	Boolean
Опубликовать в ArcGIS Online (Дополнительный)	Определяет, будет ли опубликован веб-слой, веб-инструмент или граф знаний. Все опубликованные веб-слои, веб-инструменты или графы знаний доступны через Мои ресурсы. Даже если вы захотите предоставить доступ лишь определенной группе в своей организации, все равно этот веб-слой, веб-инструмент или граф знаний будет также распространяться через Мои ресурсы. Отмечено — Ваши ресурсы будут опубликованы в ArcGIS Online или ArcGIS Enterprise. Этот веб-слой, веб-инструмент или граф знаний будет отображен в списке на странице Мои ресурсы. Не отмечено — Ваши ресурсы не будут опубликованы в ArcGIS Online или ArcGIS Enterprise и будут недоступны для других пользователей ArcGIS Online или ArcGIS Enterprise и клиентов из веб. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	Boolean
Общий доступ для всех (публичный) (Дополнительный)	Указывает, будет ли веб-слой или веб-инструмент доступен для общественности. Отмечено — Ваши ресурсы будут доступны для всех. Не отмечено — Ваши ресурсы будут не будут доступны для всех. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо выполнить вход на портал. Этот параметр не учитывается при публикации на ArcGIS Server. Этот параметр не поддерживается при публикации графа знаний.	Boolean
Доступ для вашей организации (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен в пределах вашей организации. Отмечено — Ваши ресурсы будут доступны в пределах вашей организации. Не отмечено — Ваши ресурсы будут недоступны в пределах вашей организации. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации картографического сервиса или сервиса геообработки на ArcGIS Server.	Boolean
Доступ для групп (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен для определенной группы в вашей организации. Отмечено — Ваши ресурсы будут доступны для определенной группы. Не отмечено — Ваши ресурсы будут недоступны для определенной группы. Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	String
Выходные ID элементов (Дополнительный)	Указывает ID элементов выходных веб-слоев или графов знаний, размещенных во входном определении сервиса. ID элемента может быть указан для каждого элемента. ID должен быть доступен и содержать 32 буквенно-цифровых значения в диапазоне от букв a до f и цифр от 0 до 9. Если ID не указан, ID элемента будет автоматически создан. ID можно указать для следующих элементов: Векторный веб-слой - ArcGIS Enterprise 10.8.1 или более поздней версии Веб-слой листов - ArcGIS Enterprise 10.8.1 или новее Слой изображения карты - ArcGIS Enterprise 11.2 или более поздней версии Слой объектов OGC - ArcGIS Enterprise 11.2 или более поздней версии WMS - ArcGIS Enterprise 11.2 или более поздней версии WFS - ArcGIS Enterprise 11.2 или более поздней версии Граф знаний—ArcGIS Enterprise 12.0 or later Этот параметр недоступен, если для определения сервиса установлена опция перезаписи существующего сервиса или если предоставлено подключение ArcGIS Server или URL к ArcGIS Server.	Value Table

Производные выходные данные

Подпись	Описание	Тип данных
URL-адрес сервиса SOAP	URL-адрес сервиса SOAP, опубликованного на сервере.	String
URL-адрес сервиса REST	URL-адрес сервиса REST, опубликованного на сервере.	String
ID элемента размещенного картографического сервиса	ID элемента слоя изображений карты, опубликованного на портале.	String
ID элемента размещенного сервиса объектов	ID элемента размещенного векторного слоя, опубликованного на портале.	String
Кэшированный сервис	Сервис изображений или картографический сервис с включенной возможностью кэширования.	Image Service; Map Server
URL сервиса объектов	URL-адрес REST размещенного векторного слоя, опубликованного на портале.	String
URL картографического сервиса	URL-адрес REST слоя изображений карты, опубликованного на портале.	String
ID слоя	Опубликованные слои и их ID в формате Layer1|ID1;Layer2|ID2; и т.п.	String
URL Сервиса	Опубликованные автономные таблицы и их ID в формате Table1|ID1;Table2|ID2; и т.п.	String
ID элемента размещенного сервиса векторных листов	ID элемента сервиса векторных тайлов.	String
URL-адрес сервиса векторных листов	REST URL сервиса векторный тайлов.	String
ID элемента	ID веб-элементов, размещенных на портале. ID элемента будет включать одну из следующих строк: web_feature_layer_id web_tile_layer_id map_image_layer_id ogc_feature_layer_id wms_id wfs_id knowledge_graph_id	Value Table

Python

arcpy.server.UploadServiceDefinition(in_sd_file, in_server, {in_service_name}, {in_cluster}, {in_folder_type}, {in_folder}, {in_startupType}, {in_override}, {in_my_contents}, {in_public}, {in_organization}, {in_groups}, {in_item_id})

Имя	Описание	Тип данных
in_sd_file	Файл определения сервиса (.sd), который содержит всю информацию, необходимую для публикации веб-слоя, локатора, веб-инструмента, сервиса или графа знаний.	File
in_server	Тип сервера. Поддерживаются следующие типы серверов: Мои размещенные сервисы – Используется при публикации размещенного веб-слоя на ArcGIS Online или ArcGIS Enterprise. Введите Мои размещенные сервисы для подключения сервера. Все слова должны начинаться с заглавных букв, и между словами должны быть пробелы. HOSTING_SERVER – Используется при публикации размещенного веб-слоя на ArcGIS Online или ArcGIS Enterprise. Адрес URL интегрированного сервера портала ArcGIS Enterprise – используйте при публикации слоя изображений карты на интегрированном сервере портала ArcGIS Enterprise. Подключение ArcGIS Server – используйте при публикации картографического сервиса или сервиса геообработки на ArcGIS Server. Вы можете использовать подключения ArcGIS Server, перечисленные в узле Серверы в окне Проект, или перейти в другую папку, где могут храниться файлы подключения к серверу. URL-адрес ArcGIS Server – используется при публикации картографического сервиса или сервиса геообработки на ArcGIS Server. Вы можете указать URL ArcGIS Server при условии, что в проект ArcGIS Pro было добавлено подключение издателя к ArcGIS Server, и что вы открываете этот проект в скрипте или запускаете инструмент в ArcGIS Pro. KNOWLEDGE_SERVER—Использовать при публикации графа знаний в ArcGIS Enterprise 12.0 или более поздней версии.	ServerConnection
in_service_name (Дополнительный)	Имя сервиса, которое перезапишет текущее имя сервиса, указанное в определении сервиса.	String
in_cluster (Дополнительный)	Имя кластера, которое перезапишет текущий кластер, которому был назначен сервис. Вы должны выбрать из кластеров на указанном сервере. Прежние версии: Кластеры в ArcGIS Enterprise 10.5.1 признаны устаревшими. Этот параметр будет проигнорирован серверами, которые не поддерживают множественные кластеры.	String
in_folder_type (Дополнительный)	Задает тип папки, который используется для определения источника для папки. По умолчанию папка поступает из определения сервиса. Вы также можете получить список папок, существующих на указанном сервере, или задать новую папку, которая будет создана после публикации этого веб-слоя, сервиса или графа знаний. NEW—Будет создана новая папка. EXISTING—Будет использоваться существующая папка на сервере. FROM_SERVICE_DEFINITION—Будет использоваться папка из определения сервиса. Это значение по умолчанию	String
in_folder (Дополнительный)	Папка, которая будет использоваться для веб-слоя, сервиса или графа знаний. Если папка не указана, то будет использоваться папка, указанная в определении сервиса. Если вы выбрали NEW для in_folder_type, используйте этот параметр, чтобы указать новое имя папки. Если вы выбрали EXISTING для in_folder_type, то вы можете выбрать одну из существующих на сервере папок.	String
in_startupType (Дополнительный)	Определяет, будет ли сервис запущен после публикации. STARTED—Сервис запускается после публикации. Это значение по умолчанию STOPPED—Сервис не запускается после публикации.	Boolean
in_override (Дополнительный)	Задает, будут ли перезаписываться настройки общего доступа, заданные в определении сервиса. Эти свойства определяют, будете ли вы публиковать и каким образом веб-слой, веб-инструмент или граф знаний с помощью ArcGIS Online или ArcGIS Enterprise. OVERRIDE_DEFINITION—Настройки общего доступа, заданные в определении сервиса, будут перезаписаны. USE_DEFINITION—Настройки общего доступа, заданные в определении сервиса, не будут перезаписаны, они будут использоваться. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	Boolean
in_my_contents (Дополнительный)	Определяет, будет ли опубликован веб-слой, веб-инструмент или граф знаний. Все опубликованные веб-слои, веб-инструменты или графы знаний доступны через Мои ресурсы. Даже если вы захотите предоставить доступ лишь определенной группе в своей организации, все равно этот веб-слой, веб-инструмент или граф знаний будет также распространяться через Мои ресурсы. SHARE_ONLINE—Ваши ресурсы будут опубликованы в ArcGIS Online или ArcGIS Enterprise. Этот веб-слой, веб-инструмент или граф знаний будет отображен в списке на странице Мои ресурсы. NO_SHARE_ONLINE—Ваши ресурсы не будут опубликованы в ArcGIS Online или ArcGIS Enterprise и будут недоступны для других пользователей ArcGIS Online или ArcGIS Enterprise и клиентов из веб. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо выполнить вход на портал. Этот параметр не учитывается при публикации на ArcGIS Server.	Boolean
in_public (Дополнительный)	Указывает, будет ли веб-слой или веб-инструмент доступен для общественности. PUBLIC—Ваши ресурсы будут доступны для всех. PRIVATE—Ваши ресурсы будут не будут доступны для всех. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server. Этот параметр не поддерживается при публикации графа знаний.	Boolean
in_organization (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен в пределах вашей организации. SHARE_ORGANIZATION—Ваши ресурсы будут доступны в пределах вашей организации. NO_SHARE_ORGANIZATION—Ваши ресурсы будут недоступны в пределах вашей организации. Это значение по умолчанию Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	Boolean
in_groups [in_groups,...] (Дополнительный)	Список имен групп, в которых предоставляется доступ к веб-слою, веб-инструменту или графу знаний. Для того чтобы переписать свойства общего доступа, необходимо войти на ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации на ArcGIS Server.	String
in_item_id [in_item_id,...] (Дополнительный)	Указывает ID элементов выходных веб-слоев или графов знаний, размещенных во входном определении сервиса. ID элемента может быть указан для каждого элемента. ID должен быть доступен и содержать 32 буквенно-цифровых значения в диапазоне от букв a до f и цифр от 0 до 9. Если ID не указан, ID элемента будет автоматически создан. ID можно указать для следующих элементов: web_feature_layer_id—ArcGIS Enterprise 10.8.1 или более поздние версии web_tile_layer_id—ArcGIS Enterprise 10.8.1 или более поздние версии map_image_layer_id—ArcGIS Enterprise 11.2 или более поздние версии ogc_feature_layer_id—ArcGIS Enterprise 11.2 или более поздние версии wms_id—ArcGIS Enterprise 11.2 или более поздние версии wfs_id—ArcGIS Enterprise 11.2 или более поздние версии knowledge_graph_id—ArcGIS Enterprise 12.0 или более поздние версии Этот параметр недоступен, если для определения сервиса установлена опция перезаписи существующего сервиса или если предоставлено подключение ArcGIS Server или URL к ArcGIS Server.	Value Table

Производные выходные данные

Имя	Описание	Тип данных
out_soap_svc_url	URL-адрес сервиса SOAP, опубликованного на сервере.	String
out_rest_svc_url	URL-адрес сервиса REST, опубликованного на сервере.	String
out_mapServiceItemID	ID элемента слоя изображений карты, опубликованного на портале.	String
out_featServiceItemID	ID элемента размещенного векторного слоя, опубликованного на портале.	String
out_cached_service	Сервис изображений или картографический сервис с включенной возможностью кэширования.	Image Service; Map Server
out_featureServiceURL	URL-адрес REST размещенного векторного слоя, опубликованного на портале.	String
out_mapServiceURL	URL-адрес REST слоя изображений карты, опубликованного на портале.	String
out_LayerIDMap	Опубликованные слои и их ID в формате Layer1|ID1;Layer2|ID2; и т.п.	String
out_standaloneTableIDMap	Опубликованные автономные таблицы и их ID в формате Table1|ID1;Table2|ID2; и т.п.	String
out_vectorTileServiceID	ID элемента сервиса векторных тайлов.	String
out_vectorTileServiceURL	REST URL сервиса векторный тайлов.	String
out_item_id	ID веб-элементов, размещенных на портале. ID элемента будет включать одну из следующих строк: web_feature_layer_id web_tile_layer_id map_image_layer_id ogc_feature_layer_id wms_id wfs_id knowledge_graph_id	Value Table

Пример кода

UploadServiceDefinition, пример 1 (автономный скрипт)

Следующий скрипт публикует список слоев карты как веб-слой листов в ArcGIS Enterprise или ArcGIS Online. Информация о портале извлекается из функции SignInToPortal.

import arcpy
import os

# Sign in to portal
arcpy.SignInToPortal("https://www.arcgis.com", "MyUserName", "MyPassword")

# Set output file names
outdir = r"C:\Project\Output"
service = "TileSharingDraftExample"
sddraft_filename = service + ".sddraft"
sddraft_output_filename = os.path.join(outdir, sddraft_filename)

# Reference map to publish
aprx = arcpy.mp.ArcGISProject(r"C:\Project\World.aprx")
m = aprx.listMaps("World")[0]
lyrs = []
lyrs.append(m.listLayers('Cities')[0])
lyrs.append(m.listLayers('Counties')[0])

# Create TileSharingDraft and set service properties
sharing_draft = m.getWebLayerSharingDraft("HOSTING_SERVER", "TILE", service, lyrs)
sharing_draft.summary = "My Summary"
sharing_draft.tags = "My Tags"
sharing_draft.description = "My Description"
sharing_draft.credits = "My Credits"
sharing_draft.useLimitations = "My Use Limitations"

# Create Service Definition Draft file
sharing_draft.exportToSDDraft(sddraft_output_filename)

# Stage Service
sd_filename = service + ".sd"
sd_output_filename = os.path.join(outdir, sd_filename)
arcpy.server.StageService(sddraft_output_filename, sd_output_filename)

# Share to portal
print("Start Uploading")
result = arcpy.server.UploadServiceDefinition(sd_output_filename, "My Hosted Services")

value_table_op = arcpy.ValueTable(2)
value_table_op.loadFromString(result[11])
for i in range(0, value_table_op.rowCount):
   print(value_table_op.getRow(i))

print("Finish Publishing")

UploadServiceDefinition, пример 2 (автономный скрипт)

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

import arcpy

# Set local variables
inSdFile = r"C:\Project\MapServiceDraftExample.sd"
inServer = r"C:\Project\gisserver.ags.esri.com.ags"
inServiceName = "newServiceName"
inFolderType = "NEW"
inFolder = "newFolder"
inStartup = "STOPPED"

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName, 
                                     in_folder_type=inFolderType, in_folder=inFolder, 
                                     in_startupType=inStartup)

UploadServiceDefinition, пример 3 (автономный скрипт)

Следующий скрипт загружает существующее определение сервиса на ArcGIS Online или ArcGIS Enterprise и использует дополнительные параметры, чтобы изменить свойства этого сервиса. Необязательный параметр in_item_id используется, чтобы указать ID элемента для веб-слоя при публикации на ArcGIS Enterprise.

import arcpy

# Sign in to portal
arcpy.SignInToPortal("https://organization.example.com/webadaptorname",
                     "MyUserName", "MyPassword")

# Set local variables
inSdFile = r"C:\Project\MapImageLayer_WFS_WMSExample.sd"
inServer = "https://gisserver.example.com/webadaptor"
inServiceName = "newServiceName"
inFolderType = "EXISTING"
inFolder = "existingFolder"
inOverride = "OVERRIDE_DEFINITION"
inMyContents = "SHARE_ONLINE"
inPublic = "PRIVATE"
inOrganization = "NO_SHARE_ORGANIZATION"
inGroups = ["My Group", "MyGroup 2"]

# Replace "itemid1" and "itemid2" with desired item IDs
item_id = "wfs_id itemid1; wms_id itemid2"

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName,
                                     in_folder_type=inFolderType,
                                     in_folder=inFolder,
                                     in_override=inOverride,
                                     in_my_contents=inMyContents,
                                     in_public=inPublic,
                                     in_organization=inOrganization,
                                     in_groups=inGroups,
                                     in_item_id=item_id)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да