Docs Support Console

Class /GOOG/CL_TPU_V2

Class

 /GOOG/CL_TPU_V2 
  • Inheriting from: /GOOG/CL_HTTP_CLIENT
  • Description: Cloud TPU API v2
For general information about a class in ABAP SDK for Google Cloud, see API client stub .

Types

Type Description Visibility
TY_001
AcceleratorConfig PUBLIC
TY_002
AcceleratorType PUBLIC
TY_003
AccessConfig PUBLIC
TY_004
AttachedDisk PUBLIC
TY_007
GenerateServiceIdentityResponse PUBLIC
TY_008
GetGuestAttributesRequest PUBLIC
TY_009
GetGuestAttributesResponse PUBLIC
TY_010
GuestAttributes PUBLIC
TY_011
GuestAttributesEntry PUBLIC
TY_012
GuestAttributesValue PUBLIC
TY_013
ListAcceleratorTypesResponse PUBLIC
TY_014
ListLocationsResponse PUBLIC
TY_015
ListNodesResponse PUBLIC
TY_016
ListOperationsResponse PUBLIC
TY_017
ListRuntimeVersionsResponse PUBLIC
TY_018
Location PUBLIC
TY_019
NetworkConfig PUBLIC
TY_020
NetworkEndpoint PUBLIC
TY_021
Node PUBLIC
TY_022
Operation PUBLIC
TY_023
RuntimeVersion PUBLIC
TY_024
SchedulingConfig PUBLIC
TY_025
ServiceAccount PUBLIC
TY_026
ServiceIdentity PUBLIC
TY_027
ShieldedInstanceConfig PUBLIC
TY_029
Status PUBLIC
TY_031
Symptom PUBLIC
TY_036
FailedData PUBLIC
TY_037
Guaranteed PUBLIC
TY_038
Interval PUBLIC
TY_039
ListQueuedResourcesResponse PUBLIC
TY_040
MultisliceParams PUBLIC
TY_041
NodeSpec PUBLIC
TY_043
QueuedResource PUBLIC
TY_044
QueuedResourceState PUBLIC
TY_045
QueueingPolicy PUBLIC
TY_050
Tpu PUBLIC
TY_T_001
AcceleratorConfig PUBLIC
TY_T_002
AcceleratorType PUBLIC
TY_T_004
AttachedDisk PUBLIC
TY_T_010
GuestAttributes PUBLIC
TY_T_011
GuestAttributesEntry PUBLIC
TY_T_018
Location PUBLIC
TY_T_019
NetworkConfig PUBLIC
TY_T_020
NetworkEndpoint PUBLIC
TY_T_021
Node PUBLIC
TY_T_022
Operation PUBLIC
TY_T_023
RuntimeVersion PUBLIC
TY_T_031
Symptom PUBLIC
TY_T_041
NodeSpec PUBLIC
TY_T_043
QueuedResource PUBLIC
TY_T_STRING
Table of Strings PUBLIC

Constants

Name Type Description Value Visibility
C_SUPPORTED_AUTH
/GOOG/SUPP_AUTH Supported Auth Types IJIJWW PUBLIC
C_SERVICE_NAME
/GOOG/SERVICE_NAME Google Service Name tpu:v2 PUBLIC
C_ROOT_URL
STRING API Root URL https://tpu.googleapis.com PUBLIC
C_REVISION_DATE
DATUM Discovery Document revision Date 20250227 PUBLIC
C_PATH_PREFIX
STRING API Path Prefix PUBLIC
C_ON_PREM_VERSION
/GOOG/SDK_VERSION Lowest On-premises Version 1.10 PUBLIC
C_CLOUD_VERSION
/GOOG/SDK_VERSION Lowest Cloud Version PUBLIC

Methods

For general information about a method in ABAP SDK for Google Cloud, see API method .

CONSTRUCTOR

  • Description: Constructor
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_KEY_NAME
IMPORTING /GOOG/KEYNAME Google Cloud Key Name
IV_LOG_OBJ
IMPORTING BALOBJ_D Application log: Object name (Application code)
IV_LOG_SUBOBJ
IMPORTING BALSUBOBJ Application Log: Subobject

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

CANCEL_OPERATIONS

  • Description: tpu.projects.locations.operations.cancel
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_OPERATIONS_ID
IMPORTING STRING operationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING DATA Output Data
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

CREATE_NODES

  • Description: tpu.projects.locations.nodes.create
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_NODEID
IMPORTING STRING nodeId
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IS_INPUT
IMPORTING TY_021 Node
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

CREATE_QUEUED_RESOURCES

  • Description: tpu.projects.locations.queuedResources.create
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_QUEUEDRESOURCEID
IMPORTING STRING queuedResourceId
IV_Q_REQUESTID
IMPORTING STRING requestId
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IS_INPUT
IMPORTING TY_043 QueuedResource
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

DELETE_NODES

  • Description: tpu.projects.locations.nodes.delete
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

DELETE_OPERATIONS

  • Description: tpu.projects.locations.operations.delete
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_OPERATIONS_ID
IMPORTING STRING operationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING DATA Output Data
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

DELETE_QUEUED_RESOURCES

  • Description: tpu.projects.locations.queuedResources.delete
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_FORCE
IMPORTING STRING force
IV_Q_REQUESTID
IMPORTING STRING requestId
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_QUEUED_RESOURCES_ID
IMPORTING STRING queuedResourcesId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GENERATE_SERVICE_IDENTITY_L

  • Description: tpu.projects.locations.generateServiceIdentity
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IS_INPUT
IMPORTING DATA Input Data
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_007 GenerateServiceIdentityResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_ACCELERATOR_TYPES

  • Description: tpu.projects.locations.acceleratorTypes.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_ACCELERATOR_TYPES_ID
IMPORTING STRING acceleratorTypesId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_002 AcceleratorType
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_GUEST_ATTRIBUTES_NODES

  • Description: tpu.projects.locations.nodes.getGuestAttributes
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
IS_INPUT
IMPORTING TY_008 GetGuestAttributesRequest
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_009 GetGuestAttributesResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_LOCATIONS

  • Description: tpu.projects.locations.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_018 Location
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_NODES

  • Description: tpu.projects.locations.nodes.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_021 Node
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_OPERATIONS

  • Description: tpu.projects.locations.operations.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_OPERATIONS_ID
IMPORTING STRING operationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_QUEUED_RESOURCES

  • Description: tpu.projects.locations.queuedResources.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_QUEUED_RESOURCES_ID
IMPORTING STRING queuedResourcesId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_043 QueuedResource
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

GET_RUNTIME_VERSIONS

  • Description: tpu.projects.locations.runtimeVersions.get
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_RUNTIME_VERSIONS_ID
IMPORTING STRING runtimeVersionsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_023 RuntimeVersion
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_ACCELERATOR_TYPES

  • Description: tpu.projects.locations.acceleratorTypes.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_FILTER
IMPORTING STRING filter
IV_Q_ORDERBY
IMPORTING STRING orderBy
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_013 ListAcceleratorTypesResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_LOCATIONS

  • Description: tpu.projects.locations.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_FILTER
IMPORTING STRING filter
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_014 ListLocationsResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_NODES

  • Description: tpu.projects.locations.nodes.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_015 ListNodesResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_OPERATIONS

  • Description: tpu.projects.locations.operations.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_FILTER
IMPORTING STRING filter
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_016 ListOperationsResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_QUEUED_RESOURCES

  • Description: tpu.projects.locations.queuedResources.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_039 ListQueuedResourcesResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

LIST_RUNTIME_VERSIONS

  • Description: tpu.projects.locations.runtimeVersions.list
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_FILTER
IMPORTING STRING filter
IV_Q_ORDERBY
IMPORTING STRING orderBy
IV_Q_PAGESIZE
IMPORTING STRING pageSize
IV_Q_PAGETOKEN
IMPORTING STRING pageToken
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_017 ListRuntimeVersionsResponse
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

PATCH_NODES

  • Description: tpu.projects.locations.nodes.patch
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_Q_UPDATEMASK
IMPORTING STRING updateMask
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
IS_INPUT
IMPORTING TY_021 Node
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

RESET_QUEUED_RESOURCES

  • Description: tpu.projects.locations.queuedResources.reset
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_QUEUED_RESOURCES_ID
IMPORTING STRING queuedResourcesId
IS_INPUT
IMPORTING DATA Input Data
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

START_NODES

  • Description: tpu.projects.locations.nodes.start
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
IS_INPUT
IMPORTING DATA Input Data
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

STOP_NODES

  • Description: tpu.projects.locations.nodes.stop
  • Visibility: PUBLIC

Parameters

Name Category Type Description
IV_P_PROJECTS_ID
IMPORTING STRING projectsId
IV_P_LOCATIONS_ID
IMPORTING STRING locationsId
IV_P_NODES_ID
IMPORTING STRING nodesId
IS_INPUT
IMPORTING DATA Input Data
ES_RAW
EXPORTING DATA Raw Output Data
ES_OUTPUT
EXPORTING TY_022 Operation
EV_RET_CODE
EXPORTING I Return Code
EV_ERR_TEXT
EXPORTING STRING Error Text
ES_ERR_RESP
EXPORTING /GOOG/ERR_RESP Error Response

Exception

Name Description
/GOOG/CX_SDK ABAP SDK for Google Cloud: Exception Class

CLOSE

  • Description: Close Connection
  • Visibility: PUBLIC
Create a Mobile Website
View Site in Mobile | Classic
Share by: