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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Определение сервиса

Файл определения сервиса (.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 AllSource было добавлено подключение издателя к ArcGIS Server, и что вы открываете этот проект в скрипте или запускаете инструмент в ArcGIS AllSource.

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

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

ПодписьОписаниеТип данных
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

arcpy.management.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_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 AllSource было добавлено подключение издателя к ArcGIS Server, и что вы открываете этот проект в скрипте или запускаете инструмент в ArcGIS AllSource.

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

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

ИмяОписаниеТип данных
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

Пример кода

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

Следующий скрипт публикует список слоев карты как веб-слой листов в ArcGIS Enterprise или ArcGIS Online. Информацию о портале можно получить на странице Порталы в ArcGIS AllSource.

import arcpy
import os

# 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("Uploading Service Definition...")
arcpy.server.UploadServiceDefinition(sd_output_filename, "My Hosted Services")

print("Successfully Uploaded service.")
UploadServiceDefinition, пример 2 (автономный скрипт)

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

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inSdFile = "myMapService.sd"
inServer = "myServerConnection.ags"
inServiceName = "newServiceName"
inCluster = "myCluster"
inFolderType = "NEW"
inFolder = "newFolder"
inStartup = "STOPPED"

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName, 
                                     inCluster, inFolderType, inFolder, 
                                     inStartup)
UploadServiceDefinition, пример 3 (автономный скрипт)

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

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inSdFile = "myMapService.sd"
inServer = "HOSTING_SERVER"
inServiceName = "newServiceName"
inCluster = "myCluster"
inFolderType = "EXISTING"
inFolder = "existingFolder"
inStartup = "STOPPED"
inOverride = "OVERRIDE_DEFINITION"
inMyContents = "SHARE_ONLINE"
inPublic = "PRIVATE"
inOrganization = "NO_SHARE_ORGANIZATION"
inGroups = ["My Group", "MyGroup 2"]

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName, 
                                     inCluster, inFolderType, inFolder, 
                                     inStartup, inOverride, inMyContents, 
                                     inPublic, inOrganization, inGroups)

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

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