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

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

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

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

Этот инструмент загружает и публикует веб-слой, локатор, веб-инструмент, сервис или граф знаний на основе входного определения сервиса.
Этот инструмент не загружает и не публикует файлы черновика определения сервиса (.sddraft). Если у вас есть черновое определение сервиса, вы можете преобразовать его в организованное определение сервиса с помощью инструмента Разместить сервис.
Веб-инструменты можно опубликовать только на ArcGIS Enterprise. Сервисы геообработки можно публиковать только в ArcGIS Server.
Локаторы можно опубликовать только на ArcGIS Enterprise. Сервисы геокодирования можно публиковать только в ArcGIS Server.
Графы знаний можно опубликовать только на ArcGIS Enterprise 12.0 или более поздней версии.
Вы можете задать ID элементов при публикации следующих элементов с соответствующими версиями ArcGIS Enterprise:
- Web feature layer that copies all data—ArcGIS Enterprise 10.8.1 и новее
- Web tile layer—ArcGIS Enterprise 10.8.1 и новее
- Map image layer—ArcGIS Enterprise 11.2 и более поздние версии
- Web feature layer that references registered data—ArcGIS Enterprise 11.2 и более поздние версии
- OGC feature layer—ArcGIS Enterprise 11.2 и более поздние версии
- WMS service layer—ArcGIS Enterprise 11.2 и более поздние версии
- WFS service layer—ArcGIS Enterprise 11.2 и более поздние версии
- Knowledge graphs—ArcGIS Enterprise 12.0 и более поздние версии

Подпись	Объяснение	Тип данных
Определение сервиса	Файл определения сервиса (`.sd`), который содержит всю информацию, необходимую для публикации веб-слоя, локатора, веб-инструмента, сервиса или графа знаний.	File
Сервер	Тип сервера. Поддерживаются следующие типы серверов: My Hosted Services—Используется при публикации размещенного веб-слоя в ArcGIS Online или ArcGIS Enterprise. Введите Мои размещенные сервисы для подключения сервера. Все слова должны начинаться с заглавных букв, и между словами должны быть пробелы. HOSTING_SERVER—Используется при публикации размещенного веб-слоя в ArcGIS Online или ArcGIS Enterprise. URL to the ArcGIS Enterprise portal federated server—Используйте при публикации веб-инструмента или слоя изображений карты на интегрированном сервере портала ArcGIS Enterprise. ArcGIS Server connection—Используйте при публикации картографического сервиса или сервиса геообработки в ArcGIS Server. Вы можете использовать подключения ArcGIS Server, перечисленные в узле Серверы в окне Проект, или перейти в другую папку, где могут храниться файлы подключения к серверу. URL to 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 Server. Отмечено–Ваши ресурсы будут опубликованы в ArcGIS Online или ArcGIS Enterprise. Этот веб-слой, веб-инструмент или граф знаний будет отображен в списке на странице Мои ресурсы. Не отмечено–Ваши ресурсы не будут доступны в ArcGIS Online или ArcGIS Enterprise и будут недоступны для других пользователей ArcGIS Online или ArcGIS Enterprise в интернете. Используется по умолчанию.	Boolean
Общий доступ для всех (публичный) (Дополнительный)	Указывает, будет ли веб-слой или веб-инструмент доступен для общественности. Для того чтобы изменить свойства общего доступа, необходимо войти в ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации в ArcGIS Server. Этот параметр не поддерживается при публикации графа знаний. Отмечено–Ваши ресурсы будут доступны для всех. Не отмечено–Ваши ресурсы будут не будут доступны для всех. Используется по умолчанию.	Boolean
Доступ для вашей организации (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен в пределах вашей организации. Для того чтобы изменить свойства общего доступа, необходимо войти в ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации в ArcGIS Server. Отмечено–Ваши ресурсы будут доступны в пределах вашей организации. Не отмечено–Ваши ресурсы будут недоступны в пределах вашей организации. Используется по умолчанию.	Boolean
Доступ для групп (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен для определенной группы в вашей организации. Checked—Ваши ресурсы будут доступны для определенной группы. Unchecked—Ваши ресурсы будут недоступны для определенной группы. Для того чтобы изменить свойства общего доступа, необходимо войти в 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 или более поздней версии Этот параметр недоступен, если для определения сервиса задана опция перезаписи существующего сервиса или если предоставлено подключение ArcGIS Server или URL ArcGIS Server. Столбцы таблицы значений: Item Type–The item type. Item ID–The item IDs of the output web layers staged in the input service definition.	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

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	Тип сервера. Поддерживаются следующие типы серверов: My Hosted Services—Используется при публикации размещенного веб-слоя в ArcGIS Online или ArcGIS Enterprise. Введите Мои размещенные сервисы для подключения сервера. Все слова должны начинаться с заглавных букв, и между словами должны быть пробелы. HOSTING_SERVER—Используется при публикации размещенного веб-слоя в ArcGIS Online или ArcGIS Enterprise. URL to the ArcGIS Enterprise portal federated server—Используйте при публикации веб-инструмента или слоя изображений карты на интегрированном сервере портала ArcGIS Enterprise. ArcGIS Server connection—Используйте при публикации картографического сервиса или сервиса геообработки в ArcGIS Server. Вы можете использовать подключения ArcGIS Server, перечисленные в узле Серверы в окне Проект, или перейти в другую папку, где могут храниться файлы подключения к серверу. URL to 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, и каким образом. Для того чтобы изменить свойства общего доступа, необходимо войти в ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации в ArcGIS Server. `OVERRIDE_DEFINITION`–Настройки общего доступа, заданные в определении сервиса, будут перезаписаны. `USE_DEFINITION`–Настройки общего доступа, заданные в определении сервиса, не будут перезаписаны, они будут использоваться. Используется по умолчанию.	Boolean
in_my_contents (Дополнительный)	Определяет, будет ли опубликован веб-слой, веб-инструмент или граф знаний. Все опубликованные веб-слои, веб-инструменты или графы знаний доступны через Мои ресурсы. Даже если вы захотите предоставить доступ лишь определенной группе в своей организации, все равно этот веб-слой, веб-инструмент или граф знаний будет также распространяться через Мои ресурсы. Для того чтобы переписать свойства общего доступа, необходимо выполнить вход на портал. Этот параметр не учитывается при публикации в ArcGIS Server. `SHARE_ONLINE`–Ваши ресурсы будут опубликованы в ArcGIS Online или ArcGIS Enterprise. Этот веб-слой, веб-инструмент или граф знаний будет отображен в списке на странице Мои ресурсы. `NO_SHARE_ONLINE`–Ваши ресурсы не будут доступны в ArcGIS Online или ArcGIS Enterprise и будут недоступны для других пользователей ArcGIS Online или ArcGIS Enterprise в интернете. Используется по умолчанию.	Boolean
in_public (Дополнительный)	Указывает, будет ли веб-слой или веб-инструмент доступен для общественности. Для того чтобы изменить свойства общего доступа, необходимо войти в ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации в ArcGIS Server. Этот параметр не поддерживается при публикации графа знаний. `PUBLIC`–Ваши ресурсы будут доступны для всех. `PRIVATE`–Ваши ресурсы будут не будут доступны для всех. Используется по умолчанию.	Boolean
in_organization (Дополнительный)	Определяет, будет ли веб-слой, веб-инструмент или граф знаний доступен в пределах вашей организации. Для того чтобы изменить свойства общего доступа, необходимо войти в ArcGIS Online или ArcGIS Enterprise. Этот параметр не учитывается при публикации в ArcGIS Server. `SHARE_ORGANIZATION`–Ваши ресурсы будут доступны в пределах вашей организации. `NO_SHARE_ORGANIZATION`–Ваши ресурсы будут недоступны в пределах вашей организации. Используется по умолчанию.	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. Столбцы таблицы значений: `Item Type`–The item type. `Item ID`–The item IDs of the output web layers staged in the input service definition.	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: Да

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

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

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

Параметры

Прежние версии:

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

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

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

Связанные разделы